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内 容 提 要 


本 书 主要 探讨 SQLAlchemy, X^ Python 库 在 关系 型 数据 库 和 传统 编程 之 间架 起 了 一 座 桥 
梁 ， 有 助 于 Python 程序 员 将 应 用 程序 连接 到 关系 型 数据 库 。 本 书 首先 通过 对 比 的 方式 介绍 了 
SQLAlchemy 的 两 种 主要 使 用 模式 一 一 SQLAlchemy Core 和 SQLAlchemy ORM， 然 后 探讨 了 数 
据 库 迁 移 工具 Alembic 的 用 法 ， 最 后 快速 讲解 了 SOLAlchemy 的 高 级 应 用 。 

本 书 适合 Python 开发 人 员 阅 读 。 
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我 们 周围 到 处 都 是 数据 ， 数 据 的 存储 、 更 新 以 及 报表 制作 是 每 个 应 用 程序 应 该 具备 的 关键 
功能 。 无 论 你 开发 的 是 Web 应 用 程序 、 桌 面 应 用 程序 还 是 其 他 应 用 程序 ， 你 都 需要 确保 可 
以 快速 、 安 全 地 获取 数据 。 如 今 ， 关 系 型 数据 库 仍然 是 存放 数据 最 常用 的 方式 之 一 。 


SQL 是 一 种 用 来 查询 和 操作 数据 库 数 据 的 强大 语言 ， 但 有 时 我 们 很 难 将 其 与 所 开发 的 应 
用 程序 集成 在 一 起 。 使 用 Python 做 开发 时 ， 你 可 能 使 用 字符 串 创建 过 在 ODBC 接口 上 运 
行 的 查询 ， 也 可 能 用 过 DB API。 虽 然 这 些 方法 可 以 有 效 地 处 理 数据 ， 但 安全 性 令 人 担忧 ， 
而 且 也 很 难 对 数据 库 做 出 调整 。 






































本 书 主要 探讨 SQLAlchemy， 这 是 一 个 非常 强大 又 相当 灵活 的 Python 库 ， 它 在 关系 型 数据 
库 和 传统 编程 之 间架 起 了 一 座 桥 梁 。 虽 然 SQLAlchemy 允许 我 们 使 用 原始 SQL 执行 查询 ， 
但 是 它 更 鼓励 我 们 使 用 其 提供 的 高 级 方法 来 查询 和 更 新 数据 库 。SQLAlchemy 提供 的 方法 
用 起 来 很 友好 ， 而 且 具 有 鲜明 的 Python 风格 。SQLAlchemy 还 提供 了 许多 很 棒 的 工具 ， 通 
过 这 些 工 具 ， 你 可 以 轻松 地 将 应 用 程序 中 的 类 和 对 象 同 数据 库 表 映射 起 来 ， 然 后 “忘掉 
它 ”， 或 者 不 断 回 到 模型 调 优 性 能 












































SQLAlchemy 功能 强大 并 且 十 分 灵活 ， 但 也 有 点 令 人 望 而 生 旦 。SQLAlchemy 教程 只 讲 
了 这 个 优秀 库 中 的 一 小 部 分 内 容 。 另 外 ， 尽 管 在 线 文档 非常 多 ， 但 大 都 不 适合 用 来 学 习 
SQLAlchemy， 而 是 更 适合 用 作 参 考 资料 。 本 书 既是 一 本 SQLAIchemy 学 习 指南 ， 也 是 一 
本 方便 的 参考 手册 ， 每 当 在 工作 中 碰 到 问题 ， 你 都 可 以 拿 来 翻 一 翻 ， 相 信 你 能 很 快 地 从 中 
找到 答案 。 


本 书 重 点 讲解 SOLAlchemy 1.0 版 本 ， 但 所 讲 的 大 部 分 内 容 同 样 适用 于 之 前 的 多 个 版 
Æ. XF 0.8 之 后 的 版 本 ， 本 书 示 例 只 需 做 小 幅 调整 即 可 和 运行， 并且 大 部 分 示例 都 要 求 
SQLAlchemy 版 本 号 不 低 于 0.5, 

















本 书 主要 分 为 三 个 部 分 : SQLAlchemy Core、SQLAlchemy ORM 和 Alembic。 其 中 ， 前 两 
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个 部 分 相互 对 照 。 我 们 特意 在 每 个 部 分 使 用 相同 的 示例 ， 以 方便 你 比较 SQLAlchemy 的 两 
种 主要 用 法 。 阅 读本 书 时 ， 你 既 可 以 通读 SQLAlchemy Core 和 SQLAlchemy ORM 这 两 部 
分 内 容 ， 也 可 以 只 阅读 适合 你 当前 需要 的 那 部 分 。 


本 书 读者 


如 果 你 想 学 习 如 何在 Python 程序 中 使 用 关系 型 数据 库 ， 或 者 听 说 过 SQLAlchemy 并 且 想 了 
解 更 多 信息 ， 那 本 书 正 是 为 你 而 写 的 。 为 了 最 大 限度 地 利用 本 书 ， 你 的 Python 技能 应 该 达 
到 中 等 水 平 ， 并 且 对 SQL 数据 库 有 一 定 的 了 解 。 虽 然 我 们 努力 将 本 书 内 容 讲 得 浅显 易 懂 ， 
但 如 果 你 刚刚 开始 学 习 Python， 建 议 你 先 阅读 一 下 Bil Lubanovic 写 的 《Python 语言 及 其 
应 用 》 :一 书 ， 或 者 观看 Jessica McKellar 制作 的 “Introduction to Python” 教 学 视频 ， 这 些 
学 习 资 料 都 很 棒 。 另 外 ， 如 果 你 不 熟悉 SQL 和 数据 库 ， 可 以 先 看 看 Alan Beaulieu 编写 的 
《SQL 学 习 指 南 》 一 书 。 事 先 掌握 这 些 知识 对 于 学 习 本 书 内 容 很 有 必要 。 


如 何 使 用 书 中 示例 


本 书 中 的 大 部 分 示例 都 需要 在 REPL (”" 读 取 - 求 值 - 输 出 ”循环 ) 环境 中 运行 。 你 可 以 
在 命令 提示 符 下 输入 python 来 使 用 内 置 的 Python REPL 环境 。 这 些 示例 也 可 以 在 [Python 
notebook 中 正常 运行 。 本 书 有 几 部 分 会 教 你 创建 和 使 用 文件 ， 而 非 使 用 REPL， 比 如 第 4 
章 。 大 部 分 示例 代码 和 各 章 的 Python 文件 都 以 IPython notebook 形式 提供 给 大 家 。 更 多 有 
关 IPython 的 内 容 ， 请 去 IPython 官网 学 习 。 
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阅读 前 提 

本 书 假 定 你 已 经 掌握 了 有 关 Python 语法 和 语义 的 基础 知识 ， 特 别 是 Python 2.7 及 之 后 的 
版 本 。 你 尤其 应 该 熟悉 Python 中 的 迭代 和 对 象 ， 本 书 中 会 经 常用 到 它们 。 本 书 第 二 部 分 
讲解 面向 对 象 编 程 和 SQLAlchemy ORM。 你 还 应 该 了 解 基本 的 SQL 语法 和 关系 理论 ， 因 
为 本 书 假 设 你 已 经 熟悉 如 何 定 义 模式 和 表 ， 以 及 SELECT. INSERT, UPDATE 和 DELETE 语句 
的 创建 。 


排版 约定 


本 书 使 用 如 下 排版 约定 。 


表示 新 术语 或 重点 强调 的 内 容 。 















































注 1: 此 书 已 由 人 民 邮 电 出 版 社 出 版 ， 详 见 http://www.ituring.com.cn/book/1560。 一 一 编者 注 
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等 宽 字 体 (constant width) 
表示 程序 片段 ， 以 及 正文 中 出 现 的 变量 、 函 数 名 、 数 据 库 、 数 据 类 型 、 环 境 变 量 、 语 句 
和 关键 字 等 。 





。 加 粗 等 宽 字体 (constant width bold) 
表示 应 该 由 用 户 输入 的 命令 或 其 他 文本 。 








。 斜体 等 宽 字体 (constant width italic) 
表示 应 该 赫 换 成 用 户 输入 的 值 ， 或 根据 上 下 文 赫 换 的 值 。 


该 图 标 表示 提示 或 建议 。 


该 图 标 表示 一 般 性 说 明 。 


该 图 标 表示 警告 或 警示 。 





使 用 代码 示例 


补充 材料 〈 代 码 示 例 、 练 习 等 ) 可 以 从 https://github.com/oreillymedia/essential-sqlalchemy- 
2e 下 载 。 


本 书 是 要 帮 你 完成 工作 的 。 一 般 来 说 ， 如 果 书 中 提供 了 示例 代码 ， 你 可 以 把 它 用 在 你 的 程 
序 或 文档 中 。 除 非 你 使 用 了 很 大 一 部 分 代码 ， 否 则 无 须 联 系 我 们 获得 许可 。 比 如 ， 用 书 中 
的 几 个 代码 片段 写 一 个 程序 无 须 获得 许可 ， 销 售 或 分 发 O'Reilly 图 书 的 示例 光盘 则 需要 获 
得 许可 ，3| 用 书 中 的 示例 代码 回答 问题 无 须 获 得 许可 ， 将 书 中 大 量 的 代码 放 到 你 的 产品 文 
档 中 则 需要 获得 许可 。 

我 们 很 希望 但 并 不 强制 要 求 你 在 引用 本 书 内 容 时 加 上 引用 说 明 。 引 用 说 明 一 般 包括 书 名 、 
作者 、 出 版 社 和 JISBN。 比 如 : "Essential SOLAlchemy, Second Edition, by Jason Myers and 
Rick Copeland (O’Reilly). Copyright 2016 Jason Myers and Rick Copeland, 978-1-4919-1646-9.” 

















如 果 你 觉得 自己 对 示例 代码 的 用 法 超出 了 上 述 许可 的 范围 ， 欢 迎 你 通过 permissions) 
oreilly.com 与 我 们 联系 。 
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O'Reilly Safari 


E S f Safari (之 前 称 作 Safari Books Online) 一 个 针对 企业 、 政 府 、 教 育 
AIAN! 者 和 个 人 的 会 员 制 培训 和 参考 平台 


会 员 可 以 访问 来 自 250 多 家 出 版 商 的 上 千 种 图 书 、 培 训 视 频 、 学 习 路 径 、 互 动 式 教程 和 
精 选 播放 列表 ， 这 些 出 版 商 包 括 O'Reilly Media, Harvard Business Review, Prentice Hall 


Professional, Addison-Wesley Professional, Microsoft Press, Sams, Que, Peachpit Press, 





Adobe, Focal Press, Cisco Press, John Wiley & Sons, Syngress, Morgan Kaufmann, IBM 
Redbooks, Packt, Adobe Press, FT Press, Apress, Manning, New Riders, McGraw-Hill, 
Jones & Bartlett, Course Technology 等 。 


要 了 解 更 多 信息 ， 可 以 访问 http://www.oreilly.com/safari。 


联系 我 们 
请 把 对 本 书 的 评价 和 问题 发 给 出 版 社 。 


美 国 : 
O'Reilly Media, Inc. 
1005 Gravenstein Highway North 
Sebastopol, CA 95472 


中 国 : 
北京 市 西城 区 西直门 南大 街 2 号 成 铭 大 厦 C 座 807 (100035) 
奥 菜 利 技术 咨询 (北京) ARAE 


O'Reilly 的 每 一 本 书 都 有 专属 网 页 ， 你 可 以 在 那儿 找到 书 的 相关 信息 ， 包 括 勘误 表 “、 示 例 
代码 以 及 其 他 信息 。 本 书 的 网 站 地 址 是 : http:/oreil.ly/1wEdiw, 
































对 于 本 书 的 评论 和 技术 性 问题 ， 请 发 送 电子 邮件 到 : bookquestions@oreillycom。 





要 了 解 更 多 O'Reilly 图 书 、 培 训 课程 、 会 议和 新 闻 的 信息 ， 请 访问 以 下 网 站 


http://www.oreilly.com, 








我 们 在 Facebook 的 地 址 如 下 : http://facebook.com/oreilly , 





请 关注 我 们 的 Twitter 动态 : http://twitter.com/oreillymedia, 


我 们 的 YouTube 视频 地 址 如 下 : http:/www.youtube.com/oreillymedia。 








注 2: 本 书 中 文 版 勘误 请 到 http://www.ituring.com.cn/book/1986 查看 和 提交 。 一 一 编者 注 
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SQLAIchemy 库 用 于 与 各 种 数据 库 交 互 ， 你 可 使 用 一 种 类 似 于 Python 类 和 语句 的 方式 创建 
数据 模型 和 查询 。SQLAlchemy 库 是 Mike Bayer 在 2005 年 创建 的 ， 现 在 大 大 小 小 很 多 公 
司 都 在 使 用 它 。 事 实 上 ， 许 多 公司 都 把 SQLAlchemy 看 作 在 Python 中 使 用 关系 型 数据 库 的 
标准 方式 。 

SQLAlchemy 可 用 于 连接 大 多 数 常 见 的 数据 库 ， 比 如 Postgres, MySQL, SQLite, Oracle 等 。 
SQLAlchemy 还 提供 了 一 种 为 其 他 关系 型 数据 库 添 加 支持 的 方式 。Amazon Redshift (使 用 
PostgreSQL 自 定义 方言 ) 就 是 SQLAlchemy 社区 添加 的 数据 库 支 持 的 一 个 很 好 的 例子 。 
































在 本 章 中 ， 我 们 要 搞 清楚 为 什么 要 使 用 SQLAlchemy， 还 要 学 习 它 的 两 种 主要 模式 ， 以 及 
如 何 连 接 到 数据 库 。 


为 什么 使 用 SQLAIchemy 


使 用 SQLAlchemy 的 首要 原因 是 ， 它 将 你 的 代码 从 底层 数据 库 及 其 相关 的 SQL 特性 中 抽象 出 
X. SQLAIchemy 使 用 功能 强大 的 常见 语句 和 类 型 ， 确 保 其 SQL 语句 为 每 种 数据 库 和 供应 商 
正确 、 高 效 地 构建 出 来 ， 而 无 须 你 考虑 这 些 。 同 时 ， 这 使 得 将 逻辑 从 Oracle 迁移 到 PostgreSQL 
或 从 应 用 程序 数据 库 迁 移 到 数据 仓库 变 得 很 容易 。 它 还 有 助 于 确保 数据 在 提交 到 数据 库 之 前 得 
到 “净化 ”并 正确 地 进行 了 转 义 。 这 可 以 避免 一 些 常见 的 问题 ， 比 如 SQL 注入 攻击 。 



























































SQLAlchemy 提供 了 两 种 主要 的 使 用 模式 一 一 SQL 表达 式 语言 (通常 称 为 Core) FORM, 
这 为 我 们 使 用 SQLAlchemy 提供 了 很 大 的 灵活 性 。 这 两 种 模式 可 以 单独 使 用 ， 也 可 以 一 起 
使 用 ， 有 具体 用 法 取决 于 你 的 喜好 以 及 应 用 程序 的 需求 。 














SQLAIchemy Core 和 SQL 表达 式 语 言 
SQL 表达 式 语言 允许 我 们 以 Python 方式 使 用 常见 的 SQL 语句 和 表达 式 ， 它 是 对 标准 SQL 
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语言 的 简单 抽象 。SQL 表达 式 语言 关注 的 是 实际 的 数据 库 模式 ， 它 在 经 过 标准 化 之 后 为 大 
量 后 端 数据 库 提供 了 一 种 一 致 性 的 语言 。SQL 表达 式 语言 也 是 SQLAlchemy ORM 的 基础 。 








ORM 


SQLAlchemy ORM 类 似 于 你 在 其 他 语言 中 遇 到 的 对 象 关 系 映射 (ORM)。 它 关注 应 用 程序 
的 领域 模型 ， 并 利用 工作 单元 模式 来 维护 对 象 状态 。 它 还 在 SQL 表达 式 语言 之 上 做 了 进 一 
步 的 抽象 ， 使 用 户 能 够 以 惯用 的 方式 工作 。 你 可 以 组 合 或 搭配 使 用 ORM 与 SQL 表达 式 语 
言 ， 从 而 创建 出 功能 更 为 强大 的 应 用 程序 。ORM 中 用 到 了 一 个 声明 式 系 统 ， 该 系统 类 似 
于 许多 其 他 ORM 中 使 用 的 Active-Record 系统 ， 比 如 Ruby on Rails 中 使 用 的 那个 。 


BA ORM 极其 有 用 ,但 你 必须 记 住 ， 类 的 关联 方式 和 底层 数据 库 关系 的 工作 方式 是 有 区 
别 的 。 第 6 章 会 更 加 全 面 地 探讨 这 些 方式 如 何 影响 你 的 实现 。 





















































选择 SQLAIchemy Core 还 是 SQLAIchemy ORM 


在 使 用 SOLAlchemy 构建 应 用 程序 之 前 ， 你 要 决定 主要 使 用 ORM 还 是 Core。 选 择 使 用 
Core 还 是 ORM 作为 应 用 程序 的 主要 数据 访问 层 ， 通 常 取 决 于 多 个 因素 和 个 人 偏好 。 


Core 和 ORM 使 用 的 语法 略 有 不 同 ， 但 它们 之 间 最 大 的 区 别 是 把 数据 看 作 模 式 还 是 业务 对 
象 。SQLAlchemy Core 的 视图 以 模式 为 中 心 ， 与 传统 SQL 一 样 ， 它 关注 的 是 表 、 键 和 索引 
结构 。SQLAlchemy Core 在 数据 仓库 、 报 表 、 分 析 和 其 他 场景 中 〈 在 这些 场景 中 ， 严 格 控 
制 对 未 建 模 的 数据 进行 查询 或 操作 将 非常 有 用 ) 可 以 大 放 异 彩 。 强 大 的 数据 库 连 接 池 和 结 
果 集 优化 非常 适合 处 理 大 量 数据 ， 其 至 适合 处 理 多 个 数据 库 的 数据 。 


但 是 ， 如 果 你 主要 关注 的 是 领域 驱动 设计 ， 那 么 选用 ORM 会 更 好 ， 它 会 帮 你 把 元 数据 和 
业务 对 象 中 的 底层 模式 和 结构 封装 起 来 。 这 种 封装 使 得 和 数据 库 的 交互 变 得 更 加 容易 ， 就 
像 在 使 用 普通 的 Python 代码 一 样 。 大 多 数 常见 的 应 用 程序 都 可 以 通过 这 种 方式 进行 建 模 。 
ORM 还 可 以 有 效 地 把 领域 驱动 设计 注入 到 遗留 的 应 用 程序 或 者 到 处 是 原始 SQL 语句 的 应 
用 程序 中 。 微 服务 也 能 从 对 底层 数据 库 的 抽象 中 获 益 ， 它 使 得 开发 人 员 可 以 只 关注 正在 实 
现 的 流程 。 















































但 是 ， 由 于 ORM 构建 在 SQLAlchemy Core 之 上 ， 所 以 你 也 可 以 借助 ORM 使 用 Oracle 数 
据 仓 库 和 Amazon Redshift 这 样 的 服务 ， 就 像 和 MySQL 交互 一 样 。 因 此 ，ORM 很 适合 用 
来 合并 业务 对 象 和 仓库 数据 。 


下 面 列 出 了 几 种 应 用 场景 ， 了 解 它 们 有 助 于 你 在 Core 和 ORM 中 做 出 最 佳 选择 。 


虽然 你 使 用 的 框架 中 已 经 内 置 了 ORM， 但 你 希望 添加 更 强大 的 报表 功能 ， 请 选用 Core. 
。 如 果 你 想 在 一 个 以 模式 为 中 心 的 视图 中 查看 数据 (用 法 类 似 于 SQL)， 请 使 用 Core, 























xvi | SQLAIchemy 入 门 


如 果 你 的 数据 不 需要 业务 对 象 ， 请 使 用 Core. 

如 有 果 你 要 把 数据 看 作业 务 对 象 ， 请 使 用 ORM. 

如 有 果 你 想 快 速 创建 原型 ， 请 使 用 ORM。 

如 果 你 需要 同时 使 用 业务 对 象 和 其 他 与 问题 域 无 关 的 数据 ， 请 组 合 使 用 Core 和 ORM. 























你 已 经 了 解 了 SQLAlchemy 的 结构 以 及 Core 和 ORM 之 间 的 区 别 ， 接 下 来 开始 安装 并 使 用 
SQLAlchemy 来 连接 数据 库 。 


安装 SQLAIchemy 并 连接 到 数据 库 


SQLAIchemy 可 以 与 Python 2.6, Python 3.3 和 PyPy 2.1 或 更 高 版 本 一 起 使 用 。 建 议 使 用 
pip 来 安装 SQLAlchemy (使 用 命令 pip install sqlalchemy)。 值 得 注意 的 是 ， 还 可 以 使 
用 easy. install 和 distutils 来 安装 它 。 不 过 ， 相 比 之 下 ， 使 用 pip 安装 更 简单 。 安 装 过 程 
中 ，SQLAlchemy 会 尝试 构建 一 些 C 扩展 ， 这 些 扩展 可 以 加 快 结果 集 的 处 理 速度 ， 同 时 提 
高 内 存 使 用 效率 。 如 果 你 的 系统 中 缺少 编译 器 ， 所 以 你 想 禁 用 这 些 扩展 ， 那 么 可 以 使 用 
--gLobaL-option=- -without-cextenstons。 请 注意 ， 如 果 设 有 C 扩展 ，SQLAlchemy 的 性 
能 会 受到 影响 。 你 应 该 在 带 有 C 扩展 的 系统 上 测试 代码 ， 然 后 再 进行 优化 。 


安装 数据 库 驱 动 程序 

默认 情况 下 ，SQLAlchemy 直接 支持 SQLite3 ， 不 需要 额外 安装 驱动 程序 。 不 过 ， 在 连接 
其 他 数据 库 时 需要 额外 安装 一 个 数据 库 驱 动 程序 ， 并 且 该 驱动 程序 要 遵守 标准 的 Python 
DBAPI 规 范 (PEP-249)。 这 些 DBAPI 为 各 个 数据 库 服务 器 所 用 的 方言 提供 了 基础 ， 并 且 
为 不 同 数据 库 服 务 器 和 版 本 中 的 独特 特性 提供 了 支持 。 虽 然 许 多 数据 库 都 有 多 种 DBAPI 
可 用 ， 但 我 们 将 只 介绍 那些 最 常用 的 。 


































































































。 PostgreSQL 
Psycopg2 为 PostgreSQL 的 各 个 版 本 和 特性 提供 了 广泛 的 支持 ， 你 可 以 使 用 pip install 
psycopg2 命令 安装 它 。 

















* MySQL 
PyMySQL 是 我 用 来 连接 MySQL 数据 库 服 务 器 的 首选 Python 库 。 可 以 使 用 ptp install 
pymysql 命令 安装 它 。SQLAlchemy 支持 MySQL 4.1 及 更 高 版 本 ， 这 是 由 MySQL 的 密 
码 工 作 方式 造成 的 。 另 外 ， 如 果 某 些 语句 只 在 MySQL 的 某 个 版 本 中 可 用 ， 那 么 ， 对 于 
那些 不 支持 这 些 语 句 的 MySQL 版 本 ，SQLAlchemy 不 会 为 它们 提供 使 用 这 些 语句 的 方 
法 。 如 果 SQLAIchemy 中 的 某 个 组 件 或 函数 在 你 的 环境 下 不 起 作用 ， 那 你 首先 要 做 的 是 
查看 一 下 MySQL 文档 。 
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其 他 

SQLAlchemy 还 可 以 与 Drizzle, Firebird, Oracle, Sybase 和 Microsoft SQL Server 一 
起 使 用 。SQLAIchemy 社区 还 为 许多 其 他 的 数据 库 提 供 了 外 部 方言 ， 如 IBM DB2, 
Informix, Amazon Redshift, EXASolution, SAP SQL Anywhere, Monet 等 。 此 外 ， 
SQLAIchemy 还 对 创建 方言 提供 了 很 好 的 支持 ， 第 7 章 将 讲解 相关 内 容 。 








既然 我 们 已 经 安装 好 SQLAlchemy 和 DBAPI 了 ， 接 下 来 创建 一 个 引擎 去 连接 数据 库 。 


连接 到 数据 库 

要 连接 到 数据 库 ， 需 要 先 创建 一 个 SOLAlchemy 引擎 。SQLAIlchemy 引擎 为 数据 库 创建 一 
个 公共 接口 来 执行 SQL 语句 。 这 是 通过 包装 数据 库 连 接 池 和 方言 来 实现 的 ， 这 样 它们 就 可 
以 一 起 工作 ， 提 供 对 后 端 数 据 库 的 统一 访问 。 如 此 一 来 ， 我 们 的 Python 代码 就 不 必 考 虚数 
据 库 之 间或 DBAPI 之 间 的 差异 了 。 




















SQLAlchemy 提供 了 一 个 函数 来 创建 引擎 。 在 这 个 国 数 中 ， 你 可 以 指定 连接 字符 串 ， 以 及 
其 他 一 些 可 选 的 关键 字 参 数 。 连 接 字符 串 是 一 种 特殊 格式 的 字符 串 ， 包 含 如 下 信息 : 

















数据 库 类 型 (Postgres, MySQL 等 ) 

各 数据 库 类 型 默认 之 外 的 方言 (Psycopg2. PyMySQL 等 ) 
可 选 的 认证 细节 (用 户 名 和 密码 ) 

数据 库 位 置 (数据 库 服务 器 的 文件 或 主机 名 ) 
数据 库 服务 器 端口 (可 选 ) 

数据 库 名 (可 选 ) 


SQLite 数据 库 连 接 字 符 串 指定 了 一 个 特定 的 数据 库 文件 或 存储 位 置 。 示 例 P-1 定义 了 一 个 
存储 在 当前 目录 下 、 名 为 cookies.db 的 SQLite 数据 库 文件 ， 当 前 目录 由 第 二 行 代码 中 的 相 
对 路 径 指 定 ， 第 三 行 代码 是 一 个 内 存 数据 库 ， 第 四 行 (Unix) 和 第 五 行 (Windows) 中 指 
定 了 数据 库 文件 的 完整 路 径 。 在 Windows 平台 下 ， 连 接 字符 串 如 最 后 一 行 代码 所 示 ; 除非 
你 使 用 原始 字符 串 (r'')， 否 则 就 要 使 用 NN 进行 字符 串 转 义 。 


示例 P-1 为 SQLite 数据 库 创 建 引擎 
from sqlalchemy import create engine 
engine - create engine('sqlite:///cookies.db') 
engine2 = create engine('sqlite:///:memory:') 
engine3 = create engine('sqlite:////home/cookiemonster /cookies.db') 
engine4 = create_engine('sqlite:///c:\\Users\\cookiemonster\\cookies.db') 




















create engine 国 数 会 返回 一 个 引擎 的 实例 。 但 是 ， 在 调用 需要 使 用 连接 的 操 
Ve 〈 比 如 查询 ) 之 前 ， 它 实际 上 并 不 会 打开 连接 。 
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接 下 来 ， 让 我 们 为 名 为 mydb 的 本 地 PostgreSQL 数据 库 创 建 一 个 引擎 。 为 此 ， 我 们 先 从 
sqlalchemy A create engine 国 数 。 然 后 ， 使 用 create engine 国 数 创 建 引擎 实例 。 在 
示例 P-2 中 ， 你 会 看 到 我 把 postgresql+psycopg2 用 作 连 接 字 符 串 的 引擎 和 方言 组 件 ， 当 然 
只 使 用 postgres 也 可 以 。 相 比 于 隐 式 方式 ， 我 更 喜欢 显 式 方式 ， 这 也 正 是 “Python Z4” 
(Zen of Python) 所 提倡 的 。 


示例 P-2 为 本 地 PostgreSQL 数据 库 创 建 引擎 
from sqLaLchemy import create_engine 
engine = create engine('postgresql«psycopg2: //username:password(localhost:' V 
'5432/mydb' ) 


下 面 看 看 位 于 远程 服务 器 上 的 MySQL 数据 库 。 在 示例 P-3 中 你 会 看 到 ， 在 连接 字符 串 之 
后 ， 我 们 使 用 了 一 个 关键 字 参 数 pool_recycle， 用 来 指定 回收 连接 的 频率 。 


示例 P-3 ”为 远程 MySQL 数据 库 创建 引擎 
from sqlalchemy import create engine 
engine = create engine('mysql«pymysqLl://cookiemonster:chocolatechip' 
'Qmysql01.monster.internal/cookies', pool recycle-3600) 
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默认 情况 下 ， 超 过 8 小 时 ，MySQL 才 会 关闭 空闲 连接 。 为 了 解决 这 个 问题 ， 
可 在 创建 引擎 时 把 pool recycle 设置 为 3600， 如 示例 P-3 所 示 。 





create engine 国 数 还 有 一 些 可 选 参数 ， 如 下 所 示 。 


* echo 


开启 这 个 参数 会 记录 引擎 处 理 的 操作 ， 例 如 SQL 语句 及 其 参数 。 默 认 值 为 false。 





* encoding 
这 个 参数 用 于 指定 SQLAlchemy 所 使 用 的 字符 串 编码 方式 ， 默 认 值 为 utf-8。 大 多 数 
DBAPI 默认 支持 这 种 编码 。 但 这 个 参数 并 不 用 来 指定 后 端 数据 库 所 使 用 的 编码 类 型 。 

















* isolation level 
这 个 参数 用 来 为 SQLAlchemy 指定 隔离 级 别 。 例 如 ， 使 用 Psycopg2 的 PostgreSQL 拥有 
READ COMMITTED, READ UNCOMMITTED, REPEATABLE READ, SERIALIZABLE 和 | AUTOCOMMIT 选 
项 ， 默 认 值 为 READCOMMITTED, PyMySQL 也 有 一 样 的 选项 ， 就 mnoDB 数据 库 来 说 ， 默 
认 值 为 REPEATABLEREAD。 


可 以 使 用 isolation level 这 个 关键 字 参 数 为 任何 给 定 的 DBAPI 设置 隔离 级 


别 。 此 外 ， 还 可 以 通过 方言 连接 字符 串 中 的 键 - 值 对 来 设置 隔离 级 别 ， 比 如 
支持 这 个 方法 的 Psycopg2。 
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* pool recycle 
设置 这 个 参数 会 定期 回收 数据 库 连 接 或 者 让 数据 库 连 接 超时 。 因 为 前 面 提 到 过 的 连接 超 
时 ， 这 对 MySQL 非常 重要 。 该 参数 的 默认 值 为 -1， 表 示 不 超时 。 























初始 化 引擎 之 后 ， 就 可 以 实际 打开 数据 库 连 接 了 。 这 可 以 通过 调用 connect() 方法 实现 ， 
from sqlalchemy import create engine 
engine = create engine('mysql«pymysql://cookiemonster:chocolatechip' V 
'Qmysql01.monster.internal/cookies', pool recycle-3600) 
connection - engine.connect() 


现在 我 们 有 了 一 个 数据 库 连 接 ， 接 下 来 就 可 以 开始 使 用 SQLAIchemy Core 或 SQLAlchemy 
ORM 了 。 在 第 一 部 分 中 ， 我 们 将 讲解 SQLAlchemy Core， 并 学 习 如 何 定义 和 查询 数据 库 。 
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第 一 部 分 
SQLAlchemy Core 





既然 我 们 已 经 可 以 连接 到 数据 库 了 ， 接 下 来 学 习 一 下 如 何 使 用 SOLAlchemy Core 为 应 用 程 
序 提供 数据 库 服 务 。SQLAlchemy Core 允许 我 们 以 Python 方式 使 用 SQL 命令 和 数据 结构 ， 
即 所 谓 的 SQL 表达 式 语言 。SQLAlchemy Core BE FLA Django 或 SQLAlchemy ORM 一 


起 使 用 ， 也 可 以 作为 独立 的 解决 方案 使 用 。 
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模式 和 类 型 











我 们 要 做 的 第 一 件 事 是 定义 数据 表 存 储 什 么 样 的 数据 、 数 据 之 间 如 何 相 互 关 联 ， 以 及 数据 
上 的 约束 。 





为 了 访问 底层 数据 库 ，SQLAlchemy 需要 用 某 种 东西 来 代表 数据 库 中 的 数据 表 。 为 此 ， 可 
以 使 用 下 面 三 种 方法 中 的 一 种 : 


。 使 用 用 户 定义 的 Table 对 象 
。 使 用 代表 数据 表 的 声明 式 类 
。 从 数据 库 中 推断 




















本 章 重点 讲解 第 一 种 方法 ， 因 为 它 正 是 SQLAlchemy Core 所 采用 的 方式 。 在 掌握 了 基础 
知识 之 后 ， 我 们 会 在 后 面 章节 中 学 习 另 外 两 种 方法 。Tabte 对 象 包含 一 系列 带 有 类 型 的 列 
和 属性 ， 它 们 与 一 个 常见 的 元 数据 容器 相关 联 。 本 章 我 们 会 学 习 模 式 定义 ， 首 先 来 看 看 
SQLAlchemy 中 有 哪些 类 型 可 用 来 构建 表格 。 


1.1 类 型 
在 SQLAlchemy 中 有 四 种 类 型 可 用 


























。 通用 类 型 

。 SQL 标准 类 型 

。 厂商 自 定义 类 型 
。 用 户 定义 类 型 








SQLAlchemy 定义 了 大 量 通用 类 型 ， 它 们 是 从 各 后 端 数据 库 所 支持 的 实际 SQL 类 型 中 抽象 
出 来 的 。 这 些 类 型 在 sqlalchemy.types 模块 中 都 可 用 ， 为 方便 起 见 ， 它 们 在 sqlalchemy 模 
块 中 也 可 用 。 接 下 来 看 看 这 些 通用 类 型 为 什么 有 用 。 


Boolean 通用 类 型 一 般 使 用 BOOLEAN SQL 类 型 ， 在 Python 端 处 理 成 true 或 false。 但 是 ， 它 
在 不 支持 BOOLEAN 类 型 的 后 端 数据 库 上 使 用 SMALLINT。 幸 运 的 是 SOLAlchemy 隐藏 了 这 个 
小 细节 ， 你 可 以 坚信 ， 你 创建 的 所 有 查询 或 语句 都 能 针对 该 类 型 的 字段 正确 操作 ， 而 不 管 
你 使 用 的 是 哪 种 类 型 的 数据 库 。 你 只 需要 在 Python 代码 中 处 理 true 或 false 即 可 。 在 数据 
库 迁 移 或 分 割 后 端 系统 〈 其 中 数据 仓库 是 一 种 数据 库 类 型 ， 事 务 性 系统 是 另外 一 种 数据 库 
类 型 ) 时 ， 这 种 行为 使 得 通用 类 型 非常 强大 、 有 用 。 通 用 类 型 在 Python 和 SQL 中 分 别 对 
应 的 类 型 如 表 1-1 所 示 。 


表 1-1: 通用 类 型 及 对 应 关系 


























SQLAlchemy Python SQL 

BigInteger int BIGINT 

Boolean bool BOOLEAN 或 SMALLINT 

Date datetime.date DATE(SQLite:STRING) 
DateTime datetime.datetime DATETIME (SQLite: STRING) 
Enum str ENUM 或 VARCHAR 

Float float gy Decimal FLOAT 或 REAL 

Integer int INTEGER 

Interval datetime.timedelta INTERVAL 或 DATE. (从 纪元 开始 ) 
LargeBinary byte BLOB 或 BYTEA 

Numeric decimal.Decimal NUMERIC 或 DECIMAL 

Unicode unicode UNICODE 或 VARCHAR 

Text str CLOB 或 TEXT 

Time datetime. time DATETIME 





学 习 这 些 通用 类 型 很 重要 ， 因 为 你 会 经 常 使 用 和 定义 它们 。 











除了 表 1-1 中 列 出 的 通用 类 型 外 ， 你 还 可 以 使 用 SQL 标准 类 型 和 厂商 自 定义 类 型 。 当 通用 
类 型 因 其 类 型 或 现 有 模式 中 指定 的 特定 类 型 而 无 法 在 数据 库 模 式 中 按照 需要 使 用 时 ， 我 们 
通常 会 使 用 这 两 种 类 型 。CHAR 和 NVARCHAR 类 型 就 是 很 好 的 例子 ， 它 们 都 要 求 使 用 正确 的 
SQL 类 型 而 不 仅仅 是 通用 类 型 。 如 果 我 们 使 用 的 是 在 使 用 SQLAlchemy 之 前 就 已 经 定义 好 
的 数据 库 模 式 ， 那 么 就 要 准确 地 匹配 类 型 。 请 务必 记 住 ，SQL 标准 类 型 的 行为 和 可 用 性 因 
数据 库 而 异 。SQL 标准 类 型 在 sqlalchemy.types 模块 中 是 可 用 的 。 为 了 将 SQL 标准 类 型 
和 通用 类 型 区 分 开 ， 标 准 类 型 全 部 采用 大 写字 母 。 
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厂商 自 定义 类 型 和 SQL 标准 类 型 一 样 有 用 ， 但 是 它们 只 适用 于 特定 的 后 端 数据 库 。 可 
以 通过 所 选 方言 的 文档 或 SQLALchemy 站 点 确定 有 哪些 类 型 可 用 。 它 们 在 sqlalchemy. 
dialects 模块 中 都 是 可 用 的 ， 并 且 每 种 数据 库 方 言 都 有 若干 子 模块 。 同 样 ， 这 些 类 型 采 
用 的 全 是 大 写字 母 ， 以 便 同 通用 类 型 区 分 开 。 有 时， 我 们 可 能 想 使 用 PostgreSQL 强大 的 
JSON 字段 ， 为 此 可 以 使 用 下 面 的 语句 来 实现 : 


























from sqlalchemy.dialects.postgresql import JSON 


现在 ， 我 们 可 以 定义 JSON 字段 了 。 稍 后 ， 在 我 们 的 应 用 程序 中 ，PostgreSQL 专用 的 许多 
JSON 函数 都 会 用 到 它 ， 比 如 array_to_json 国 数 。 


你 还 可 以 自 定义 类 型 ， 以 便 用 你 选择 的 方式 存储 数据 。 例 如 ， 在 把 字符 放 入 数据 库 记录 
时 ， 将 其 放 在 存储 在 VARCHAR 列 中 的 文本 的 前 面 ， 并 在 从 记录 中 获取 这 个 字段 时 去 掉 它 们 。 
在 处 理 现 有 系统 仍然 使 用 的 遗留 数据 时 ， 这 可 能 很 有 用 ， 因 为 这 种 类 型 的 前 组 在 新 应 用 程 
序 中 可 能 没 用 或 者 并 不 重要 。 


我 们 已 经 学 习 了 用 于 创建 数据 表 的 四 种 变 体 类 型 ， 接 下 来 看 看 数据 库 结 构 是 如 何 通 过 元 数 
据 结合 在 一 起 的 。 


1.2 元 数据 

元 数据 用 来 把 数据 库 结构 结合 在 一 起 ， 以 便 在 SQLAlchemy 中 快速 访问 它 。 一 般 可 以 把 元 
数据 看 作 一 种 Table 对 象 日 录 ， 其 中 包含 与 引擎 和 连接 有 关 的 信息 。 这 些 表 可 以 通过 字典 
MetaData.tables 来 访问 。 读 操作 是 线程 安全 的 ， 但 是 表 的 创建 并 不 是 完全 线程 安全 的 。 在 
把 对 象 绑 定 到 元 数据 之 前 ， 需 要 先导 入 并 初始 化 元 数据 。 接 下 来 ， 初 始 化 MetaData 对 象 的 
一 个 实例 ， 在 本 章 的 其 余 示例 中 我 们 会 用 它 来 保存 信息 目录 : 


from sqlalchemy import MetaData 
metadata - MetaData() 


到 这 里 ， 我 们 已 经 有 了 用 来 保存 数据 库 结构 的 方法 ， 接 下 来 开始 定义 表 。 


1.3 X 


在 SQLAlchemy Core 中 ， 我 们 通过 调用 Table 构造 函数 来 初始 化 Table 对 象 。 我 们 要 在 构 
造 函 数 中 提供 Metadata 对 象 〈 元 数据 ) 和 表 名 ， 任 何其 他 参数 都 被 认为 是 列 对 象 。 此 外 ， 
还 有 一 些 额外 的 关键 字 参 数 ， 它 们 用 来 开启 相关 特性 ， 相 关内 容 稍 后 讲解 。 列 对 象 对 应 于 
数据 表 中 的 各 个 字段 。 列 是 通过 调用 Column() 函数 创建 的 ， 我 们 需要 为 这 个 函数 提供 列 
名 、 类 型 ， 以 及 其 他 表示 SQL 结构 和 约束 的 参数 。 在 本 章 的 其 余部 分 中 ， 我 们 将 创建 一 组 
表 ， 并 在 第 一 部 分 中 使 用 。 在 示例 1-1 中 ， 我 们 创建 了 一 个 表 ， 用 于 为 线 上 cookie 配送 服 
务 存储 cookie 库存 。 



















































































示例 1-1 实例 化 Table 对 象 和 列 


from sqlalchemy import Table, Column, Integer, Numeric, String, ForeignKey 


cookies - Table('cookies', metadata, 
Column('cookie id', Integer(), primary key-True), © 
Column('cookie name', String(50), index-True), @ 
Column('cookie recipe url', String(255)), 
Column('cookie sku', String(55)), 
Column('quantity', Integer()), 
Column('unit cost', Numeric(12, 2)) O 

) 


0 请 注意 我 们 把 此 列 标记 为 表 的 主键 的 方式 。 稍 后 会 详细 介绍 。 
@ 创建 cookie 名 称 索 引 ， 以 加 快 该 列 的 查询 速度 。 


e 这 个 列 包含 多 个 参数 ， 有 长 度 和 精度 ， 比 如 11.2， 其 中 长 度 最 多 为 11 位 数字 ， 精 度 为 
两 位 小 数 。 





在 深入 了 解 表 之 前 ， 需 要 先 了 解 表 的 基本 构造 块 : 列 。 


1.3.1 列 

列 用 来 定义 数据 表 中 的 字段 ， 它 们 提供 了 通过 关键 字 参 数 定义 其 他 约束 的 主要 方法 。 不 同 
类 型 的 列 的 主要 参数 是 不 一 样 的 。 例 如 ，String 类 型 的 列 的 主要 参数 是 长 度 ， 而 带 有 小 数 
部 分 的 数字 有 精度 和 长 度 。 其 他 大 部 分 类 型 没有 主要 参数 。 














有 时 你 会 看 到 有 些 String 列 没 有 长 度 这 个 主要 参数 。 这 种 行为 并 没有 被 普遍 
支持 ， 例 如 ，MySQL 和 其 他 几 个 数据 库 后 端 就 不 允许 这 样 做 。 














除 此 之 外 ， 列 还 有 其 他 一 些 关 键 字 参 数 ， 这 些 参 数 有 助 于 进一步 塑造 它们 的 行为 。 可 以 把 
列 标记 为 必需 ， 或 者 强制 它们 是 唯一 的 。 还 可 以 为 列 设置 默认 的 初始 值 ， 并 在 记录 更 新 时 
更 改 列 值 。 一 个 常见 的 用 例 是 那些 用 来 指示 何 时 为 日 志 或 审计 的 目的 创建 或 更 新 记录 的 字 
段 。 下 面 看 一 下 示例 1-2 中 的 这 些 关键 字 参 数 。 


示例 1-2 另 一 个 带 有 更 多 列 选 项 的 表 


from datetime import datetime 
from sqlalchemy import DateTime 




















users = Table('users', metadata, 
Column('user id', Integer(), primary key-True), 
Column('username', String(15), nullable-False, unique-True), Q 
Column('email address', String(255), nullable-False), 
Column('phone', String(20), nullable-False), 
Column('password', String(25), nullable-False), 
Column('created on', DateTime(), default-datetime.now), @ 
Column('updated on', DateTime(), default=datetime.now, onupdate-datetime.now) © 





第 1 章 


@ 我 们 让 这 个 列 是 必需 的 (nullable=False), ， 而 且 值 唯一 。 
e 如 果 未 指定 日 期 ， 就 把 当前 时 间 设 置 为 列 的 默认 值 。 
© 通过 使 用 onupdate， 使 得 每 次 更 新 记录 时 ， 都 把 当前 时 间 设 置 给 当前 列 。 























尔 可 能 注意 到 了 ， 我 们 在 设置 default 和 onupdate 时 使 用 的 是 datetime. 
ow， 而 没有 调用 datetime.now() 函数 。 如 果 调 用 这 个 国 数 ， 它 就 会 把 
default 设置 为 表 首 次 实例 化 的 时 间 。 通 过 使 用 datetime.now， 可 以 得 到 实 
例 化 和 更 新 每 个 记录 的 时 间 。 














我 们 一 直 使 用 列 关 键 字 参数 来 定义 表 结 构 和 约束 ， 但 是 ， 你 也 可 以 在 Column 对 象 之 外 声明 
它们 。 当 使 用 一 个 现 有 数据 库 时 ， 这 一 点 非常 重要 ， 因 为 你 必须 告诉 SQLAlchemy 数据 库 
中 的 模式 、 结 构 和 约束 。 例 如 ， 如 果 数 据 库 中 的 已 有 索引 与 SQLAlchemy 使 用 的 默认 索引 
命名 方案 不 匹配 ， 那 么 你 必须 手动 定义 该 索引 。 下 面 两 节 内 容 将 演示 如 何 做 到 这 一 点 。 








1.5 节 和 1.6 节 中 的 所 有 命令 都 包含 在 Table 构造 函数 中 ， 或 者 通过 特殊 方法 
被 添加 到 表 中 。 它 们 将 作为 独立 语句 进行 持久 化 或 附加 到 元 数据 。 





1.3.2 MAR 
键 和 约束 用 来 确保 我 们 的 数据 在 存储 到 数据 库 之 前 满足 某 些 要 求 。 可 以 在 基本 的 
SQLAlchemy 模块 中 找到 代表 键 和 约束 的 对 象 ， 其 中 三 个 常见 的 对 象 导 入 如 下 : 








from sqlalchemy import PrimaryKeyConstraint, UniqueConstraint, CheckConstraint 


最 常见 的 键 类 型 是 主键 。 主 键 用 作 数 据 库 表 中 每 个 记录 的 唯一 标识 符 ， 用 于 确保 不 同 表 
中 两 个 相关 数据 之 间 的 关系 正确 。 就 像 你 在 示例 1-1 和 示例 1-2 中 看 到 的 那样 ， 只 需 使 
用 primary key 这 个 关键 字 参 数 ， 就 可 以 让 一 个 列 成 为 主键 。 还 可 以 通过 在 多 个 列 上 将 
primary key 设置 为 True 来 定义 复合 主键 。 本 质 上 ， 键 会 被 视 为 一 个 元 组 ， 其 中 标记 为 键 
的 列 将 按照 它们 在 表 中 定义 的 顺序 出 现 。 主 键 也 可 以 在 表 构 造 国 数 的 列 之 后 定义 ， 如 下 面 
的 代码 片段 所 示 。 可 以 通过 添加 多 个 由 逗号 分 隔 的 列 来 创建 复合 键 。 如 果 想 像 示 例 1-2 那 
样 显 式 地 定义 键 ， 它 看 起 来 会 像 下 面 这 样 : 























PrimaryKeyConstraint('user id', name='user_pk') 








另 一 个 常见 的 约束 是 唯一 性 约束 ， 它 用 来 确保 给 定 字段 中 不 存在 重复 的 两 个 值 。 例 如 ， 就 
我 们 的 线 上 cookie 配送 服务 来 说 ， 我 们 希望 确保 每 个 客户 都 有 一 个 唯一 的 用 户 名 来 登录 我 
们 的 系统 。 我 们 还 可 以 为 列 分 配 唯一 约束 ， 就 像 前 面 在 username 列 中 所 做 的 那样 。 当 然 ， 
你 也 可 以 手动 定义 约束 ， 如 下 所 示 : 











UniqueConstraint('username', name='uix_username' ) 
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示例 1-2 中 没有 检查 约束 (check constraint) 类 型 。 这 种 类 型 的 约束 用 于 确保 列 数据 和 一 组 由 
用 户 定义 的 标准 相 匹配 。 在 下 面 的 示例 中 ， 我 们 会 确保 unit cost 永远 不 会 小 于 0.00， 因 为 
每 个 cookie 的 制作 都 要 花费 一 定 的 成 本 (从 经 济 学 角度 来 说 ， 就 是 没有 免费 的 cookie ! ) : 




















CheckConstraint('unit cost >= 0.00', name-'unit cost positive') 


除了 键 和 约束 之 外 ， 我 们 可 能 还 希望 提高 某 些 字 段 的 查找 效率 。 这 就 是 索引 的 作用 。 


1.3.3 索引 


索引 用 来 加 快 字段 值 的 查找 速度 。 在 示例 1-1 中 ， 我 们 在 cookte nane 列 上 创建 了 一 个 索 
引 ， 因 为 我 们 知道 以 后 会 TG CRE TT BER 在 索引 创建 好 之 后 ， 你 会 拥有 一 个 名 为 
ix cookies cookie name 的 索引 。 还 可 以 使 用 显 式 构 造 类 型 来 定义 索引 。 你 可 以 指定 多 个 
列 ， 各 列 之 间 用 逗号 分 隔 。 你 还 可 以 添加 unique=True 这 个 关键 字 参 数 ， 指 定 索 引 也 必须 
唯一 。 当 显 式 地 创建 索引 上 时， 它们 会 在 列 之 后 传递 给 Table 构造 函数 。 示 例 1-1 中 的 索引 
也 可 以 显 式 地 创建 : 

















from sqlalchemy import Index 
Index('ix cookies cookie name', 'cookie name') 





ee 函数 索引 因 所 使 用 的 后 端 数 据 库 而 略 有 不 同 。 Te 

需要 基于 某 些 不 寻常 的 上 下 文 进行 查询 的 情况 创建 索引 。 例 如 ， 如 果 我 们 想 通过 cookie 
ee ee a a ne 
引 来 优化 查找 ， 














Index('ix test', mytable.c.cookie sku, mytable.c.cookie name)) 


接 下 来 该 深入 研究 关系 型 数据 库 最 重要 的 部 分 了 : 表 关 系 以 及 如 何 定义 它们 。 


1.3.4 关联 关系 和 外 键 约束 
现在 我 们 已 经 有 了 一 个 表 ， 其 中 的 列 拥有 正确 的 约束 和 索引 。 接 下 来 看 看 如 何在 表 之 间 创 
建 关 系 。 我 们 需要 一 种 跟踪 订单 的 方法 ， 里 面 有 表示 每 种 cookie 和 订购 量 的 行 项 目 。 为 了 
帮助 理解 这 些 表 之 间 的 关系 ， 请 参阅 图 1-1。 
























































order id cookie id 
cookie id cookie name 
quantity cookie recipe url 
extended cost cookie sku 
quantity 
unit cost 


user id 

customer number 
username 
email-address 
phone 

password 
created on 
updated on 














图 1-1: 关系 可 视 化 


示例 1-3 给 出 了 实现 关系 的 一 种 方法 ， 即 在 Vine items 表 的 order_id 列 上 添加 外 键 ， 通 
过 ForeignKeyConstraint 来 定义 两 个 表 之 间 的 关系 。 示 例 中 ， 许 多 行 项 目 都 可 以 出 现在 单 
个 订单 中 。 但 是 ， 如 果 深 入 研究 Line_items 表 ， 你 会 发 现 我 们 还 通过 cookie id 这 个 外 键 
在 line items #45 cookies 表 之 间 建 立 了 关系 。 这 是 因为 line items 实际 是 orders 表 和 
cookies 表 之 间 的 一 个 关联 表 ， 其 中 包含 一 些 额外 的 数据 。 关 联 表 用 于 支持 两 个 其 他 表 之 
间 的 多 对 多 关系 。 表 上 的 单个 外 键 (ForeignKey) 通常 表示 一 对 多 的 关系 ， 但 是 ， 如 果 一 
个 表 上 存在 多 个 外 键 关 系 ， 那 么 它 很 可 能 就 是 关联 表 。 


示例 1-3 定义 更 多 表 
from sqlalchemy import ForeignKey 
orders - Table('orders', metadata, 
Column('order id', Integer(), primary key-True), 
Column('user id', ForeignKey('users.user id')), Q 
Column('shipped', Boolean(), default-False) 



































) 


line items - Table('line items', metadata, 
Column('line items id', Integer(), primary key-True), 
Column('order id', ForeignKey('orders.order id')), 
Column('cookie id', ForeignKey('cookies.cookie id')), 
Column('quantity', Integer()), 
Column('extended cost', Numeric(12, 2)) 


) 
@ 请 注意 ， 在 这 个 列 上 ， 我 们 使 用 的 是 一 个 字符 串 ， 而 不 是 对 列 的 实际 引用 。 





使 用 字符 串 而 非 实际 列 ， 这 允许 我 们 跨 多 个 模块 分 离 表 定义 ， 而 且 不 必 担 心 表 的 加 载 顺 
序 。 这 是 因为 SQLAlchemy 只 会 在 第 一 次 访问 表 名 和 列 时 对 该 字符 串 执行 解析 。 如 果 在 
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ForeignKey 定义 中 使 用 了 硬 引 用 (hardreference) ， 比 如 cookies.c.cookie id， 那 它 会 在 模 
块 初始 化 期 间 执行 解析 ， 并 且 有 可 能 失败 ， 这 取决 于 表 的 加 载 顺 序 。 





你 还 可 以 显 式 地 定义 一 个 ForeignKeyConstraint。 外 键 约束 在 试图 匹配 现 有 数据 库 模 式 ， 
以 便 与 SQLAlchemy 一 起 使 用 时 会 很 有 用 。 这 与 以 前 创建 键 、 约 束 和 索引 以 匹配 名 称 模 
式 等 的 工作 方式 相同 。 在 表 定 义 中 定义 外 键 约束 之 前 ， 需 要 先 从 sqlalchemy 模块 导入 
ForeignKeyConstraint。 下 面 的 代码 演示 了 如 何 为 Line_items 和 orders 表 之 间 的 order. id 
字段 创建 ForeignKeyConstraint. 




















ForeignKeyConstraint(['order id'], ['orders.order id']) 


到 目前 为 止 ， 我 们 一 直 以 SQLAlchemy 能 够 理解 的 方式 定义 表 。 如 果 你 的 数据 库 已 经 存 
在 ,并且 已 经 构建 好 了 模式 ， 那 接 下 来 你 可 以 着 手 编写 查询 了 。 但 是 ， 如 有 果 你 需要 创建 完 
整 的 模式 或 添加 一 个 表 ， 就 需要 知道 如 何 持久 化 表 以 实现 永久 性 存储 。 


1.4 表 的 持久 化 


事实 上 ， 所 有 表 和 模式 定义 都 与 metadata 的 实例 有 关 。 要 想 将 模式 持久 化 到 数据 库 中 ， 只 
需 调用 metadata 实例 的 create all) 方法 ， 并 提供 创建 表 的 引擎 即 可 : 











metadata.create all(engine) 











默认 情况 下 ，create_all 不 会 尝试 重新 创建 数据 库 中 已 经 存在 的 表 ， 并 且 它 可 以 安全 地 运 
行 多 次 。 使 用 Alembic 这 样 的 数据 库 迁 移 工具 来 处 理 对 现 有 表 或 额外 模式 所 做 的 更 改 ， 要 
比 直接 在 应 用 程序 代码 中 进行 编码 更 改 更 明知 (第 11 章 会 详细 地 讲解 相关 内 容 )。 现 在 我 
们 已 经 对 数据 库 中 的 表 做 了 持久 化 ， 接 下 来 看 看 示例 1-4， 里 面 是 我 们 在 本 章 中 处 理 的 表 
的 完整 代码 。 


示例 1-4 内存 中 完整 的 SQLite 代码 


from datetime import datetime 
































from sqlalchemy import (MetaData, Table, Column, Integer, Numeric, String, 
DateTime, ForeignKey, create engine) 
metadata - MetaData() 


cookies - Table('cookies', metadata, 
Column('cookie id', Integer(), primary key-True), 
Column('cookie name', String(50), index-True), 
Column('cookie recipe url', String(255)), 
Column('cookie sku', String(55)), 
Column('quantity', Integer()), 
Column('unit cost', Numeric(12, 2)) 


) 


users - Table('users', metadata, 
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Column('user id', Integer(), primary key-True), 

Column('customer number', Integer(), autoincrement-True), 

Column('username', String(15), nullable-False, unique-True), 

Column('email address', String(255), nullable-False), 

Column('phone', String(20), nullable-False), 

Column('password', String(25), nullable-False), 

Column('created on', DateTime(), default-datetime.now), 

Column('updated on', DateTime(), default=datetime.now, onupdate=datetime.now) 


) 


orders - Table('orders', metadata, 
Column('order id', Integer(), primary key-True), 
Column('user id', ForeignKey('users.user id')) 
Column('shipped', Boolean(), default-False) 


) 


line items - Table('line items', metadata, 
Column('line items id', Integer(), primary key-True), 
Column('order id', ForeignKey('orders.order id')), 
Column('cookie id', ForeignKey('cookies.cookie id')), 
Column('quantity', Integer()), 
Column('extended cost', Numeric(12, 2)) 


) 


engine = create engine('sqlite:///:memory:') 
metadata.create all(engine) 




















在 本 章 中 ， 我 们 学 习 了 SQLAlchemy 如 何 将 元 数据 用 作 目 录 来 存储 表 模 式 和 其 他 数据 ， 以 
及 如 何 定 义 一 个 拥有 多 个 列 和 约束 的 表 。 我 们 了 解 了 约束 的 类 型 ， 以 及 如 何在 列 对 象 之 
外 显 式 地 构造 它们 ， 以 匹配 现 有 的 模式 或 命名 方案 。 然 后 讨论 了 如 何 为 审计 设置 默认 值 和 
onupdate 值 。 最 后 学 习 了 如 何 把 模式 持久 化 或 保存 到 数据 库 中 以 供 重用 。 接 下 来 学 习 如 何 
通过 SQL 表达 式 语言 处 理 模 式 中 的 数据 。 
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第 2 章 


使 用 SQLAIchemy Core 处 理 数 据 





现在 数据 库 中 已 经 有 了 表 ， 接 下 来 开始 处 理 这 些 表 中 的 数据 。 我 们 先 学 习 如 何 插 入 、 检 
索 和 删除 数据 ， 然 后 学 习 如 何 对 数据 中 的 关系 进行 排序 、 分 组 和 应 用 。 我 们 会 使 用 
SQLAlchemy Core 提供 的 SQL 表达 式 语言 (SEL)。 本 章 示例 将 继续 使 用 第 1 章 中 创建 的 
表 。 首 先 学 习 如 何 插 入 数据 。 


2.1 插入 数据 


首先 ， 创 建 一 条 insert 语句 ， 用 来 把 我 最 喜欢 的 cookie (chocolate chip) 放 入 cookies # 
中 。 为 此 ， 先 调用 cookies RHY insertO 方法 ， 然 后 再 使 用 values() 语句 ， 关 键 字 参数 为 
各 个 列 及 相应 的 值 ， 如 示例 2-1 所 示 。 


示例 2-1 插入 数据 

ins = cookies.insert().values( 
cookie name-"chocolate chip", 
cookie recipe url-"http://some.aweso.me/cookie/recipe.html", 
cookie sku-"CCO1", 
quantity="12", 
unit_cost="0.50" 

) 


print(str(ins)) 





























在 示例 2-1 FP, print(str(ins)) 语句 向 我 们 展示 了 实际 要 执行 的 SQL EA: 


INSERT INTO cookies 

(cookie name, cookie recipe url, cookie sku, quantity, unit cost) 
VALUES 

(:cookie name, :cookie recipe url, :cookie sku, :quantity, :unit cost) 





在 这 个 SQL 语句 中 ， 我 们 提供 的 值 被 奉 换 为 :column name, iX tA SQLAlchemy 通过 
str() 函数 表示 参数 的 方式 。 参 数 用 来 帮助 确保 数据 被 正确 转 义 ， 从 而 减少 SQL 注 入 
攻击 等 安全 问题 。 仍 然 可 以 通过 查看 编译 后 的 插入 语句 来 查看 参数 ， 因 为 每 个 数据 库 后 
端 处 理 参数 的 方式 略 有 不 同 (这 是 由 方言 控制 的 )。ins 对 象 的 compile() 方法 返回 一 个 
SQLCompiler 对 象 ， 该 对 象 允 许 我 们 通过 params 属性 访问 随 查 询 一 起 发 送 的 实际 参数 。 











ins.compile().params 
这 将 通过 方言 编译 语句 ， 但 不 会 执行 语句 ， 并 且 我 们 要 访问 该 语句 的 params 属性 。 


结果 如 下 : 





{ 
'cookie name': 'chocolate chip', 
'cookie recipe url': 'http://some.aweso.me/cookie/recipe.html', 
'cookie sku': 'CC01', 
'quantity': '12', 
'unit cost': '0.50' 
} 








现在 ， 我 们 已 经 完全 了 解 了 插入 语句 ， 并 且 知 道 了 要 插入 到 表 中 的 内 容 。 接 下 来 可 以 使 用 
connection 的 execute() 方法 把 语句 发 送 到 数据 库 ， 数 据 库 将 把 记录 插入 到 表 中 〈 见 示例 2-2)。 


示例 2-2 执行 插入 语句 


result = connection.execute(ins) 














还 可 以 通过 访问 inserted primary key 属性 获得 刚才 插入 的 记录 的 ID: 


result.inserted primary key 

[1] 
让 我 们 快速 了 解 一 下 调用 executeO 方法 时 会 发 生 什么 。 当 构建 SQL 表达 式 语言 语句 时 ， 
比如 我 们 一 直 在 用 的 插入 语句 ， 实 际 创建 的 是 一 个 树 状 结构 ， 这 种 结构 可 以 采用 自 上 而 下 
的 方式 快速 遍历 。 当 调用 execute 方法 时 ， 它 会 使 用 传 入 的 语句 和 其 他 参数 ， 通 过 适当 的 
数据 库 方 言 的 编译 器 编译 语句 。 编 译 器 通过 遍历 树 状 结构 构建 一 个 普通 的 参数 化 SQL 18 
句 ， 而 后 该 语句 被 返回 给 execute 方法 ，execute 方法 再 通过 调用 该 方法 的 连接 把 SQL 15 
句 发 送 到 数据 库 ， 然 后 数据 库 服 务 器 执行 语句 并 返回 操作 结果 。 


insert 除了 用 作 Table 对 和 象 的 实例 方法 外 ， 还 可 以 作为 独立 函数 ， 在 你 想 要 逐步 构建 语句 
(每 次 一 步 ) 或 者 在 表 最 初 未 知 时 使 用 。 例 如 ， 我 们 公司 可 能 有 两 个 独立 的 部 门 ， 每 个 部 门 
都 有 自己 单独 的 库存 表 。 使 用 示例 2-3 中 的 insert 国 数 ， 我 们 就 可 以 使 用 一 条 语句 替换 表 。 
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示例 2-3 ”插入 函数 

from sqlalchemy import insert 

ins = insert(cookies).values( @ 
cookie name-"chocolate chip", 
cookie recipe url-' MMC dE 
cookie sku-"CC0O1" 
quantity="12" 
unit_cost="0.50" 

) 


o 请 注意 ，cookies 表现 在 用 作 insert 函数 的 参数 。 


管 是 作为 Table 对 象 的 方法 ， 还 是 作为 一 种 更 具 生 成 性 的 独立 函数 ， 
insert 都 工作 得 很 好 ， 但 我 更 喜欢 后 一 种 用 法 ， 因 为 它 更 接近 于 人 们 常见 的 
SQL 语句 。 


连接 对 象 的 execute 方法 不 仅 可 以 接受 语句 ， 还 可 以 在 语句 之 后 接受 关键 字 参 数值 。 在 编 
译 语句 时 ， 它 会 向 列 列表 添加 每 个 关键 字 参 数 键 ， 并 将 它们 的 每 个 值 添 加 到 SQL 语句 的 
VALUES 部 分 ( 见 示例 2-4)。 





示例 2-4 执行 语句 中 的 值 

ins = cookies.insert() 

result = connection.execute( 
ins, © 
cookie name-'dark chocolate chip', @ 
cookie recipe url-'http://some.aweso.me/cookie/recipe dark.html', 
cookie sku-'CC02', 
quantity-'1', 
unit cost-'0.75' 

) 


result.inserted primary key 











@ 插入 语句 是 execute 国 数 的 第 一 个 参数 ， 这 和 前 面 一 样 。 
e 我 们 以 关键 字 参 数 的 形式 把 值 添 加 到 execute 函数 。 


结果 如 下 : 





[2] 


虽然 这 在 实际 工作 中 并 不 常用 ,但 它 确 实 很 好 地 说 明了 语句 在 发 送 到 数据 库 服务 器 之 前 是 
如 何 编 译 和 组 装 的 。 可 以 通过 使 用 一 个 字典 列表 一 次 插入 多 条 i 记录， 字典 里 面包 含 我 们 要 
提交 的 数据 。 下 面 使 用 这 种 方法 把 两 种 cookie 插入 到 cookies 表 中 〈 见 示例 2-5)。 


示例 2-5 插入 多 条 记录 


inventory list = [ @ 























'cookie name': ‘peanut butter', 





'cookie recipe url': 'http://some.aweso.me/cookie/peanut.html', 
'cookie sku': 'PB01', 

'quantity': '24', 

'unit cost': '0.25' 


}, 
{ 
'cookie name': ‘oatmeal raisin', 
'cookie recipe url': 'http://some.okay.me/cookie/raisin.html', 
'cookie sku': 'EWWO1', 
'quantity': '100', 
'unit cost': '1.00' 
} 


] 


result = connection.execute(ins, inventory_list) @ 





@ 创建 cookie 列表 。 
@ 把 列表 作为 execute 函数 的 第 二 个 参数 。 
列表 中 的 字典 必须 拥有 完全 相同 的 键 。SQLAlchemy 会 根据 列表 中 的 第 一 个 


字典 编译 语句 ， 如 果 后 续 字典 不 同 ， 则 该 语句 会 失败 ， 因 为 该 语句 已 经 与 前 
面 的 列 一 起 构建 了 。 








iu 





现在 cookies 表 中 已 经 有 了 一 些 数据 ， 接 下 来 学 习 如 何 查询 表 并 获取 其 中 的 数据 。 


2.2 查询 数据 


构建 查询 时 ， 要 用 到 select 国 数 ， 它 类 似 于 标准 SQL SELECT 语句 。 首 先 从 cookies 表 获 
取 所 有 记录 〈 见 示例 2-6)。 


示例 2-6 简单 的 select 函数 
from sqlalchemy.sql import select 
S = select([cookies]) @ 
rp = connection.execute(s) 
results - rp.fetchall() O 


o 请 记 住 ， 可 以 使 用 str(s) 查看 数据 库 看 到 的 SQL 语句 ， 本 例 中 是 SELECT cookies. 
cookie id, cookies.cookie name, cookies.cookie recipe url, cookies.cookie sku, 


cookies.quantity, cookies.unit cost FROM cookies, 


@ 这 让 rp (ResultProxy) 返回 所 有 行 。 








results 变量 现在 包含 一 个 列表 ， 里 面 有 cookies 表 中 的 所 有 记录 : 


[(1, u'chocolate chip', u'http://some.aweso.me/cookie/recipe.html', u'CC01', 
12, Decimal('0.50')), 

(2, u'dark chocolate chip', u'http://some.aweso.me/cookie/recipe dark.html', 
u'CC@2', 1, Decimal('0.75')), 
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(3, u'peanut butter', u'http://some.aweso.me/cookie/peanut.html', u'PB01', 
24, Decimal('0.25')), 
(4, u'oatmeal raisin', u'http://some.okay.me/cookie/raisin.html', u'EWWO1', 
100, Decimal('1.00'))] 





在 前 面 的 示例 中 ， 我 传递 了 一 个 包含 cookies 表 的 列表 。select 方法 需要 一 个 列 列表 来 进 
行 选择 ， 但 为 了 方便 起 见 ， 它 还 可 以 接受 Table 对 象 ， 并 选择 表 中 的 所 有 列 。 也 可 以 使 用 
Table 对 象 的 select 方法 来 实现 这 一 点 ， 如 示例 2-7 所 示 。 但 是 ， 我 更 喜欢 示例 2-6 的 写法 。 





示例 2-7 简单 的 select() 方法 


from sqlalchemy.sql import select 
s = cookies.select() 

rp = connection.execute(s) 
results = rp.fetchall() 


在 深入 学 习 查 询 之 前 ， 需 要 进一步 了 解 一 下 ResultProxy 对 象 。 


2.2.1 ResultProxy 


ResultProxy 是 DBAPI 游标 对 象 的 包装 器 ， 其 主要 目标 是 让 语句 返回 的 结果 更 容易 使 用 和 
操作 。 比 如 ，ResultProxy 允许 使 用 索引 、 名 称 或 Column 对 象 进行 访问 ， 从 而 简化 了 对 查 
询 结 果 的 处 理 。 示 例 2-8 演示 了 这 三 种 方法 。 能 够 熟练 地 使 用 这 三 个 方法 来 获取 所 需 的 列 
数据 非常 重要 。 

示例 2-8 使 用 ResultProxy 处 理 行 


first row = results[0] © 

first row[1] O 

first row.cookie name © 

first row[cookies.c.cookie name] Q 
































O 获取 ResultProxy 的 第 一 行 。 
@ 通过 索引 访问 列 。 

@ 通过 名 称 访问 列 。 

@ 通过 Column 对 象 访问 列 。 


上 面 三 条 语句 的 执行 结果 都 是 'chocolate chip'， 它 们 引用 的 是 results 变量 的 第 一 条 记 
录 中 完全 相同 的 数据 元 素 。 这 种 访问 灵活 性 只 是 ResultProxy 强大 功能 的 一 部 分 。 还 可 以 
把 ResultProxy 用 作 可 碗 代 对 象 ， 对 返回 的 每 条 记录 执行 一 个 操作 ， 并 且 无 须 创 建 另 一 个 
变量 来 保存 结果 。 例 如 ， 我 们 可 能 希望 打印 数据 库 中 每 种 cookie 的 名 称 ( 见 示例 2-9). 



































示例 2-9 迭代 ResultProxy 


rp = connection.execute(s) Q 
for record in rp: 
print(record.cookie name) 
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@ 这 里 重用 了 前 面 的 select 语句 。 





返回 结果 如 下 : 


chocolate chip 
dark chocolate chip 
peanut butter 
oatmeal raisin 











除了 把 ResultProxy 用 作 可 迭代 对 象 和 调用 fetchall() 方法 之 外 ， 还 有 其 他 许多 通过 
ResultProxy 访问 数据 的 方法 。 事 实 上 ，2.1 节 中 的 所 有 result 变量 都 是 ResultProxys, 4X 
们 在 该 节 中 使 用 的 rowcount() 和 inserted_primary_key() 方法 只 是 从 ResuLtProxy 获取 信 
息 的 另外 两 种 方法 。 还 可 以 使 用 如 下 方法 来 获取 结果 。 














first() 
若 有 记录 ， 则 返回 第 一 个 记录 并 关闭 连接 。 





fetchone() 
返回 一 行 ， 并 保持 光标 为 打开 状态 ， 以 便 你 做 更 多 获取 调用 。 





scalar() 
如 果 查 询 结果 是 包含 一 个 列 的 单条 记录 ， 则 返回 单个 值 。 





























如 果 想 查看 结果 集中 的 多 个 列 ， 可 以 使 用 keys O 方法 来 获得 列 名 列表 。 在 本 章 的 其 余部 分 
中 ， 我 们 将 使 用 first, scalar, fetchone 和 fetchall 方法 以 及 ResultProxy PERITA 











最 佳 实 践 

在 编写 生产 代码 时 ， 应 该 遵循 如 下 指导 方针 。 

。 获取 单条 记录 时 ， 要 多 用 first 方法 ， 尽 量 不 要 用 fetchone 和 scalar 方法 ， 因 为 
对 程序 员 来 说 ，first 方法 更 加 清晰 。 

。 REA TIAA R ResultProxy, m AL fetchall 和 fetchone 方法 ， 因 为 前 者 
的 内 存 效率 更 高 ， 而 且 我 们 往往 一 次 只 对 一 条 记录 进行 操作 。 

。 避免 使 用 fetchone 方法 ， 因 为 如 果 不 小 心 ， 它 会 一 直 让 连接 处 于 打开 状态 。 

。 谨慎 使 用 scalar 方法 ， 因 为 如 果 查 询 返回 多 行 多 列 ， 就 会 引发 错误 ， 多 行 多 行 在 
测试 过 程 中 经 常会 丢失 。 











在 前 面 的 示例 中 ， 我 们 每 次 查询 数据 库 时 都 会 得 到 各 条 记录 的 所 有 列 。 通 常 我 们 只 需要 使 
用 这 些 列 中 的 一 部 分 。 如 果 这 些 额 外 列 中 的 数据 量 很 大 ， 就 会 导致 应 用 程序 运行 速度 变 
慢 ， 消 耗 的 内 存 远 超 预 期 。 尽 管 SQLAlchemy 不 会 向 查询 或 ResultProxys 添加 大 量 开 销 ， 
但 是 ， 如 果 查 询 占 用 了 太 多 内 存 ， 首 先 要 考虑 从 查询 返回 的 数据 是 否 有 问题 。 接 下 来 看 看 
如 何 对 查询 返回 的 列 数 进行 限制 。 
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2.2.2 ”控制 查询 中 的 列 数 
为 了 限制 查询 返回 的 列 数 ， 需 要 以 列表 的 形式 把 要 查询 的 列传 递 给 select() 方法 。 例 如 ， 
你 想 运行 一 个 查询 ， 该 查询 只 返回 cookie 的 名 称 和 数量 ， 如 示例 2-10 所 示 。 





示例 2-10 “只 包含 cookie name 和 quantity 


S = select([cookies.c.cookie name, cookies.c.quantity]) 
rp = connection.execute(s) 

print(rp.keys()) © 

result = rp.first() O 


0 返回 所 选 列 的 列表 ， 在 本 例 中 是 ['cookie name','quantity'] (这 只 用 来 演示 ， 不 是 必 
需 的 )。 

@ 请 注意 ， 这 条 语句 只 返回 第 一 个 结果 。 

结果 如 下 : 
(u'chocolate chip', 12), 


我 们 已 经 可 以 构建 简单 的 select 语句 了 ， 接 下 来 看 看 还 可 以 做 些 什么 来 改变 select 语句 
返回 结果 的 方式 。 首 先 学 习 如 何 改变 返回 结果 的 顺序 。 


2.2.3 HEF 

如 果 查 看 示例 2-10 的 所 有 结果 ， 而 不 仅仅 是 第 一 条 记录 ， 你 会 发 现 数 据 并 不 是 按照 特定 
顺序 排列 的 。 如 果 希 望 返 回 的 列表 有 特定 的 顺序 ， 可 以 使 用 order_by() 语句 ， 如 示例 2-11 
所 示 。 示 例 中 ， 我 们 希望 结果 按照 现 有 cookie 的 数量 进行 排序 。 






































示例 2-11 Fe quantity 进行 升序 排列 


s = select([cookies.c.cookie name, cookies.c.quantity]) 
S = s.order by(cookies.c.quantity) 
rp = connection.execute(s) 
for cookie in rp: 
print('{} - {}'.format(cookie.quantity, cookie.cookie name)) 


结果 如 下 : 


1 - dark chocolate chip 
12 - chocolate chip 

24 - peanut butter 

100 - oatmeal raisin 





我 们 先 把 select 语句 保存 到 变量 s 中 ， 而 后 向 变量 s 中 添加 order_by 语句 ， 再 将 其 重 
新 赋 给 s 变量 。 这 个 示例 演示 了 如 何以 生成 式 或 分 步 方式 编写 语句 。 也 可 以 把 select 和 
order by 语句 放 在 一 行 中 ， 如 下 所 示 : 


S = select([...]).order by(...) 
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然而 ， 当 select 中 有 完整 的 列 列表 ，order_by 语句 中 有 order 列 时 ， 它 超过 了 Python 每 
fr 79 个 字符 的 限制 (这 是 在 PEP8 中 建立 的 )。 通 过 使 用 生成 类 型 语句 ， 可 以 保持 不 超出 
该 限制 。 在 本 书 中 ， 我 们 将 看 到 一 些 例 子 ， 其 中 生成 类 型 语句 可 以 带 来 额外 的 好 处 ， 例 如 
有 条 件 地 向 语句 中 添加 内 容 。 现 在 ， 尝 试 按 照 每 行 TO 个 字符 的 限制 分 割 语句 ， 这 将 有 助 
于 提升 代码 的 可 读 性 。 


如 果 你 想 按 倒序 或 降序 排列 ， 可 使 用 desc() 语句 。desc() 函数 的 作用 是 按 降序 包装 你 要 
排序 的 特定 列 ， 如 示例 2-12 所 示 。 


示例 2-12 FX quantity 进行 降序 排列 
from sqlalchemy import desc 
s = select([cookies.c.cookie name, cookies.c.quantity]) 
S = s.order by(desc(cookies.c.quantity)) © 














0 请 注意 ， 这 一 行 中 ， 我 们 使 用 desc() 函数 对 cooktes.c.quantity 列 进行 了 包装 。 


desc() 国 数 还 可 以 作为 Column 对 象 (比如 cookie.c.quantity.desc()) 的 方 
法 进行 调用 。 但 是 ， 如 果 在 长 语句 中 这 样 使 用 ， 可 能 会 造成 阅读 困难 ， 所 以 
我 总 是 把 desc() 用 作 函 数 。 





























如 有 果 应 用 程序 只 需要 返回 结果 的 一 部 分 ， 可 以 对 返回 的 结果 数量 进行 限制 。 


2.2.4 BRIER SRS 

在 前 面 的 示例 中 ， 我 们 使 用 firstO 或 fetchone() 方法 仅 获 取 一 行 。 虽 然 ResultProxy fE 
供 了 我 们 请 求 的 那 行 ， 但 查询 实际 运行 时 会 访问 所 有 结果 ， 而 不 仅仅 是 单个 记录 。 如 果 想 
对 查询 进行 限制 ， 可 以 使 用 Limit() 函数 让 limit 语句 成 为 查询 的 一 部 分 。 比 如 ， 你 的 时 
间 只 够 制作 两 批 cookie， 你 想 知道 应 该 制作 哪 两 种 cookie， 那 么 你 可 以 使 用 前 面 的 有 序 查 
询 ， 并 添加 Limit 语句 来 返回 最 需要 补充 的 两 种 cookie ( 见 示例 2-13). 




















示例 2-13 ”两 种 库存 量 最 少 的 cookie 
select([cookies.c.cookie name, cookies.c.quantity]) 
S = s.order by(cookies.c.quantity) 

S = s.limit(2) 

rp = connection.execute(s) 

print([result.cookie name for result in rp]) © 





S 


@ 这 里 ， 我 们 在 列表 中 使 用 了 ResultsProxy 的 可 迭代 功能 。 
结果 如 下 : 





[u'dark chocolate chip', u'chocolate chip'] 


现在 ， 你 已 经 知道 需要 烤 哪 两 种 cookie 了 ， 你 可 能 还 想 知 道 当 前 库存 中 还 有 多 少 cookie, 
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许多 数据 库 都 包含 SOL 函数 ， 这 些 函 数 的 设计 目的 是 让 某 些 操作 可 以 直接 在 数据 库 服 务 器 
上 使 用 ， 比 如 SUM。 接 下 来 了 解 一 下 如 何 使 用 SQL 函数 。 


2.25 ”内置 SQL 函 数 和 标签 


SQLAIchemy 还 可 以 利用 后 端 数 据 库 中 的 SQL 函数 。 两 个 非常 常用 的 数据 库 函 数 是 SUM() 
和 COUNT()。 要 使 用 这 两 个 函数 ， 需 要 导入 sqlalchemy.sql.func 模块 。 这 些 函 数 被 包装 在 
它们 操作 的 列 上 。 因 此 ， 要 获得 cookie 的 总 数 ， 可 以 使 用 示例 2-14。 


示例 2-14 计算 cookie 的 总 数 
from sqLaLchemy.sqL import func 
S = select([func.sum(cookies.c.quantity)]) 
rp = connection.execute(s) 
print(rp.scalar()) © 














o 请 注意 ， 这 里 使 用 了 scalar()， 它 只 返回 第 一 个 记录 最 左边 的 列 。 
结果 如 下 : 
137 


我 总 是 导入 func 模块 ， 因 为 直接 导入 sum 可 能 会 引起 问题 ， 而 且 还 容易 和 
Python 内 置 的 sum 函数 混淆 。 


接 下 来 使 用 count 函数 查看 一 下 cookies KARA JLA cookie ( 见 示例 2-15)。 
示例 2-15 统计 库存 中 有 儿 种 cookie 


S = select([func.count(cookies.c.cookie name)]) 
rp = connection.execute(s) 

record = rp.first() 

print(record.keys()) © 

print(record.count_1) @ 


@ 显示 ResultProxy 中 的 列 。 
eO 自动 生成 列 名 ,一般 格 式 为 : «func name» «position», 
结果 如 下 : 


[u'count 1'] 
4 





这 个 列 名 既 烦 人 又 麻烦 。 另 外 ， 如 果 查 询 中 有 多 个 统计 ， 那 我 们 必须 知道 它们 在 语句 中 
出 现 的 次 数 ， 并 将 其 合并 到 列 名 ， 因 此 第 四 个 count() 函数 将 是 count_4。 命 名 应 该 清 








晰 、 明 确 ， 特 别 是 当 周 围 有 其 他 Python 代码 时 。 不 过 ， 值 得 庆幸 的 是 ，SQLAlchemy 提供 
了 labelO 国 数 来 解决 这 个 问题 。 示 例 2-16 执行 的 查询 与 示例 2-15 一 样 ， 但 它 通 过 调用 
label() 函数 为 我 们 访问 的 列 起 了 一 个 更 有 用 的 名 字 。 


示例 2-16 使 用 lable() 进行 重 命名 


s = select([func.count(cookies.c.cookie name).label('inventory count')]) © 
rp = connection.execute(s) 

record = rp.first() 

print(record.keys()) 

print(record.inventory count) 




















0 请 注意 ， 只 在 要 更 改 的 列 对 象 上 调用 LabeL() 函数 即 可 。 
结果 如 下 : 








[u'inventory count'] 
4 





我 们 已 经 学 习 了 如 何 限制 从 数据 库 返 回 的 列 数 或 行 数 。 接 下 来 学 习 如 何 根据 指定 的 条 件 对 
查询 数据 进行 过 着。 


2.2.6 过滤 

对 查询 进行 过 着 是 通过 添加 where() 语句 来 完成 的 ， 和 在 SQL 中 一 样 。 典 型 的 where() FA 
包含 一 个 列 、 一 个 运算 符 和 一 个 值 或 列 。 可 以 把 多 个 where() 子 句 接 在 一 起 使 用 ， 功 能 就 像 
传统 SQL 语句 中 的 AND 一 样 。 在 示例 2-17 中 ， 我 们 将 查找 名 为 “chocolate chip” HYJ cookie. 








示例 2-17 使 用 cookie name 进行 过 滤 
S = select([cookies]).where(cookies.c.cookie name == 'chocolate chip') 
rp = connection.execute(s) 
record = rp.first() 
print(record.items()) © 


@ 这 里 我 调用 了 行 对 象 的 items() 方法 ， 该 方法 返回 一 个 包含 列 名 和 列 值 的 列表 。 
结果 如 下 : 
[ 


(u'cookie id', 1), 

(u'cookie name', u'chocolate chip'), 

(u'cookie recipe url', u'http://some.aweso.me/cookie/recipe.html'), 
(u'cookie sku', u'CC01'), 

(u'quantity', 12), 

(u'unit cost', Decimal('0.50')) 


] 
还 可 以 使 用 where() 语句 来 查找 所 有 包含 “chocolate” 这 个 词 的 cookie 名 ( 见 示例 2-18). 
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示例 2-18 ”查找 包含 chocolate HJ cookie 名 


S = select([cookies]).where(cookies.c.cookie name.like('*chocolate*')) 
rp = connection.execute(s) 
for record in rp.fetchall(): 

print(record.cookie name) 


结果 如 下 : 


chocolate chip 
dark chocolate chip 


在 示例 2-18 的 where() 语句 中 ， 我 们 将 cookies.c.cookie_name 列 用 作 一 种 ClauseElement 
来 过 滤 结 果 。 我 们 应 该 花 一 些 时 间 了 解 一 下 ClauseElement 及 其 提供 的 其 他 功能 。 

















2.2.7 ClauseElement 


ClauseElement 是 在 子 句 中 使 用 的 实体 ， 一般 是 表 中 的 列 。 不 过 ， 与 列 不 同 的 是 ，ClauseElement 
拥有 许多 额外 的 功能 。 在 示例 2-18 中 ， 我 们 调用 了 ClauseElement 的 like() 方法 。 此 外 还 
有 许多 其 他 方法 可 供 选用 ， 如 表 2-1 所 示 。 这 些 方法 的 结构 和 标准 SQL 语句 类 似 。 你 会 在 
本 书 中 找到 各 种 各 样 的 例子 。 


表 2-1: ClauseElement 方 法 






































方 法 用 途 

between(cleft, cright) 查找 在 cleft 和 cright 之 间 的 列 
concat(column two) 连接 列 

distinct() 查找 列 的 唯一 值 

in ([list]) 查找 列 在 列表 中 的 位 置 

is_(None) 查找 列 None 的 位 置 (通常 用 于 检查 Null 和 None) 
contains( string) 查找 包含 string 的 列 ( 区 分 大 小 写 ) 
endswith( string) 查找 以 string 结尾 的 列 (区 分 大 小 写 ) 
like(string) 查找 与 string 匹配 的 列 (区 分 大 小 写 ) 
startswith( string) 查找 以 string 开头 的 列 (区 分 大 小 写 ) 
ilike(string) 查找 与 string 匹配 的 列 (不 区 分 大 小 写 ) 

















这 些 方法 也 存在 相反 的 版 本 ， 例 如 notLike 和 notin_()。not< 方 法 > 这 种 命 
名 约定 的 唯一 例外 是 不 带 下 划 线 的 isnot() 方法 。 














除了 使 用 表 2-1 中 列 出 的 方法 外 ， 还 可 以 在 where 子 句 中 使 用 运算 符 。 大 多 数 运算 符 的 工 
作 方 式 和 你 预想 的 一 样 。 接 下 来 详细 地 讲解 一 下 运算 符 ， 它 们 之 间 存 在 一 些 差异 。 








2.2.8 运算 符 

到 目前 为 止 ， 我 们 用 来 过 滤 数 据 的 方法 有 两 种 : 一 是 利用 列 是 否 等 于 某 个 值 ， 二 是 使 
用 ClauseElement 的 方法 ， 比 如 tike()。 然 而 ， 还 可 以 使 用 许多 常见 的 运算 符 来 过 滤 数 
Hi. SOLAlchemy 对 大 多 数 标 准 Python 运算 符 做 了 重 载 ， 包 括 所 有 标准 的 比较 运算 符 
(==、!=、<、>、<=、>=)， 它 们 的 功能 和 在 Python 语句 中 完全 一 样 。 在 与 None 比较 时 ，== 
运算 符 被 重 载 为 ITS NULL 语句 。 算 术 运 算 符 (\+、-、*、/ 和 %) 还 可 以 用 来 对 独立 于 数据 
库 的 字符 串 做 连接 处 理 ， 如 示例 2-19 所 示 。 


示例 2-19 使 用 \+ 连接 字符 串 
S = select([cookies.c.cookie name, 'SKU-' + cookies.c.cookie sku]) 
for row in connection.execute(s): 
print(row) 

















结果 如 下 : 


(u'chocolate chip', u'SKU-CC01') 
(u'dark chocolate chip', u'SKU-CC02') 
(u'peanut butter', u'SKU-PB01') 
(u'oatmeal raisin', u'SKU-EWWO1') 





运算 符 的 另 一 个 常见 用 法 是 根据 多 个 列 来 计算 值 。 在 处 理财 务 数据 或 统计 数据 的 应 用 程序 
和 报表 中 ， 你 经 常 要 这 样 做 。 示 例 2-20 是 计算 库存 价值 的 一 个 例子 。 


示例 2-20 计算 各 种 cookie 的 库存 价值 
from sqlalchemy import cast @ 
S - select([cookies.c.cookie name, 
cast((cookies.c.quantity * cookies.c.unit cost), 
Numeric(12,2)).label('inv cost')]) O 
for row in connection.execute(s): 
print('{} - (jJ'.format(row.cookie name, row.inv cost)) 











O Cast() 是 另 一 个 允许 做 类 型 转换 的 国 数 。 本 例 中 ， 我 们 要 获取 6.0000000000 这 样 的 
结果 ， 因 此 需要 进行 强制 类 型 转换 ， 使 其 看 起 来 像 货 币 。 在 Python 中， 还 可 以 使 用 
print('() - (:.2f)'.format(row.cookie name, row.inv cost)) 完成 相同 的 任务 。 

@ 请 注意 ， 这 里 再 次 使 用 Label() 函数 对 列 进行 重 命名 。 如 果 不 进行 重 命名 ， 列 就 会 被 命 
名 为 anon_1， 因 为 操作 本 身 不 会 产生 名 字 。 


结果 如 下 : 




















chocolate chip - 6.00 
dark chocolate chip - 0.75 
peanut butter - 6.00 
oatmeal raisin - 100.00 
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2.2.9 布尔 运算 符 


SQLAlchemy 还 支持 SQL 布尔 运算 符 AND、OR 和 NOT， 它 们 用 位 运算 符 (&8、| 和 ~) 
来 表示 。 受 Python 运算 符 优先 级 规则 的 影响 ， 在 使 用 AND. OR 和 NOT 重 载运 算 符 时 
一 定 要 特别 小 心 。 比 如 ，& tk < 优先 级 高 ， 所 以 当 你 写 A < B & C < D 时 ， 你 想得到 的 是 
(A < B) &(C < D)， 而 实际 得 到 的 却 是 A < (B&C) < D。 请 尽量 使 用 连接 词 (conjunction), 
不 要 用 这 些 重 载运 算 符 ， 因 为 连接 词 会 让 你 的 代码 更 清晰 易 懂 。 








通常 ， 我 们 希望 用 包含 和 排除 的 方式 把 多 个 whereO 子 句 链接 在 一 起 ， 这 可 以 通过 使 用 连 





接 词 来 完成 。 


2.2.10 ”连接 词 











接 词 来 实现 ， 而 且 使 用 连接 词 的 可 读 性 更 好 、 功 能 性 更 强 。SQLAlchemy 中 的 连接 词 





为 了 实现 某 种 期 望 的 效果 ， 我 们 既 可 以 把 多 个 where() 子 句 链接 在 一 起 ， 也 可 以 使 用 连 
是 


and (), or () 和 not_()。 如 果 想 获得 价格 低 于 某 个 数 且 数量 超过 指定 值 的 cookie 列表 


可 以 使 用 示例 2-21 中 的 代码 。 
示例 2-21 EH and() 连接 词 


from sqlalchemy import and , or , not. 
S = select([cookies]).where( 
and ( 
cookies.c.quantity > 23, 
cookies.c.unit_cost < 0.40 
) 
) 
for row in connection.execute(s): 
print(row.cookie_name) 





























or_() 函数 的 作用 与 and_() 函数 正好 相反 ， 只 要 记录 满足 其 中 一 个 条 件 ， 就 会 被 选 出 来 。 
如 果 想 搜索 库存 中 数量 在 10 到 50 之 间或 名 字 包 含 chip 的 cookie， 可 以 使 用 示例 2-22 中 














的 代码 。 
示例 2-22 使 用 or() 连接 词 


from sqlalchemy import and , or , not. 
S = select([cookies]).where( 
or_( 


cookies.c.quantity.between(10, 50), 
cookies.c.cookie_name.contains('chip') 


) 

) 

for row in connection.execute(s): 
print(row.cookie_name) 


结果 如 下 : 





chocolate chip 
dark chocolate chip 
peanut butter 


not () 函数 的 工作 方式 与 其 他 连接 词类 似 ， 用 来 选择 那些 与 指定 条 件 不 匹配 的 记录 。 到 这 
里 ,我 们 已 经 可 以 轻松 地 查询 数据 了 ， 接 下 来 该 学 习 如 何 更 新 现 有 数据 了 。 


2.3 更 新 数据 


update() 方法 和 前 面 用 过 的 insert() 方法 很 相似 ， 它 们 的 语法 几乎 完全 一 样 ， 但 是 
update() 可 以 指定 一 个 where 子 句 ， 用 来 指出 要 更 新 哪些 行 。 与 插入 语句 一 样 ， 更 新 语句 
可 以 由 update() 函数 或 者 表格 的 update() 方法 来 创建 。 如 果 省 略 where 子 句 ， 则 表示 要 
更 新 表 中 的 所 有 行 。 


例如 ， 假 设 你 已 经 完成 了 库存 所 需 的 巧克力 饼干 (chocolate chip cookies) 的 烘焙 工作 。 在 
示例 2-23 中 ， 我 们 先 通 过 更 新 查询 把 烘焙 好 的 巧克力 饼干 添加 到 当前 库存 中 ， 再 查看 当前 
库存 中 巧克力 饼干 的 数量 。 


示例 2-23 ”更 新 数据 
from sqlalchemy import update 
u = update(cookies).where(cookies.c.cookie name == "chocolate chip") 
u = u.values(quantity-(cookies.c.quantity + 120)) © 
result = connection.execute(u) 
print(result.rowcount) @ 
S = select([cookies]).where(cookies.c.cookie name == "chocolate chip") 
result - connection.execute(s).first() 
for key in result.keys(): 
print('{:>20}: {}'.format(key, result[key])) 






































@ 使 用 生成 方法 构建 语句 。 
e 打印 更 新 的 行 数 。 


结果 如 下 : 


1 
cookie id: 1 
cookie name: chocolate chip 
cookie recipe url: http://some.aweso.me/cookie/recipe.html 
cookie sku: CC01 
quantity: 132 
unit cost: 0.50 


除了 更 新 数据 之 外 ， 某 些 时 候 ， 我 们 还 想 从 表 中 删除 某 些 数据 ， 接 下 来 就 学 习 删 除数 据 的 
方法 。 
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2.4 删除 数据 


创建 删除 语句 时 ， 既 可 以 使 用 deLete() 国 数 ， 也 可 以 使 用 表 (包含 待 删 数据 的 表 ) 的 
delete() 方法 。 与 insert() 和 update() Ala], delete() 不 接收 值 参数 ， 只 接收 一 个 可 选 的 
where 子 句 ， 用 来 指定 删除 范围 (省 略 where 子 句 表示 删除 表 中 的 所 有 行 )。 请 看 示例 2-24。 


示例 2-24 ”删除 数据 














from sqlalchemy import delete 

u = delete(cookies).where(cookies.c.cookie name == "dark chocolate chip") 
result - connection.execute(u) 

print(result.rowcount) 


select([cookies]).where(cookies.c.cookie name -- "dark chocolate chip") 


result - connection.execute(s).fetchall() 


s = 
print(len(result)) 
结果 如 下 : 
1 
0 


现在 ， 让 我 们 综合 运用 前 面 学 过 的 内 容 向 users, orders 和 line_items 表 中 加 载 一 些 数 








据 。 你 可 以 直接 复制 下 钙 








i 这 些 代 码 进 行 添加 ， 但 最 好 花 点 时 间 尝 试 使 用 不 同 的 插入 数据 的 





方法 。 
customer list = [ 

{ 
'username': 'cookiemon', 
'email address': 'mon@cookie.com', 
'phone': '111-111-1111', 
'password': 'password' 

}, 

{ 
'username': 'cakeeater', 
'email address': 'cakeeater@cake.com', 
'phone': '222-222-2222', 
'password': 'password' 

}, 

{ 
'username': 'pieguy', 
'email address': 'guy(pie.com', 
'phone': '333-333-3333', 
'password': 'password' 

} 


] 


ins = users.insert() 
result = connection.execute(ins, customer list) 


现在 我 们 有 了 客户 ， 接 下 来 开始 把 他 们 的 订单 和 行 项 目 输入 到 系统 中 





ins = insert(orders).values(user id-1, order id-1) 
result = connection.execute(ins) 

ins = insert(line items) 

order items - [ 


{ 
‘order_id': 1, 
'cookie id': 1, 
'quantity': 2, 
'extended cost': 1.00 
}, 
{ 
‘order_id': 1, 
'cookie id': 3, 
'quantity': 12, 
'extended cost': 3.00 
} 


] 

result = connection.execute(ins, order_items) 

ins = insert(orders).values(user_id=2, order_id=2) 
result = connection.execute(ins) 

ins = insert(line items) 

order_items = [ 


{ 
‘order_id': 2, 
'cookie id': 1, 
'quantity': 24, 
'extended cost': 12.00 
}, 
{ 
'order id': 2, 
'cookie id': 4, 
'quantity': 6, 
'extended cost': 6.00 
} 


] 

result = connection.execute(ins, order_items) 
第 1 章 中 ， 我 们 学 习 了 如 何 定义 ForeignKeys (spt) 和 关系 ， 但 是 到 目前 为 止 ， 我 们 还 
没有 用 它们 做 过 查询 。 下 面 就 来 看 看 这 些 关 系 。 


2.5 连接 


现在 ， 让 我 们 学 习 如 何 使 用 join() 和 outerjoin() 方法 来 查询 相关 数据 。 例 如 ， 为 了 完成 
cookiemon 客户 所 下 的 订单 ， 我 们 需要 确认 每 种 cookie 的 订购 量 。 总 共 需 要 使 用 3 个 连接 
才能 获取 cookie 的 名 称 。 需 要 注意 的 是 ， 根 据 连接 在 关系 中 的 使 用 方式 ， 可 能 需要 重新 组 
织 语句 中 的 from 部 分 。 为 此 ， 可 以 使 用 SOLAlchemy 提供 的 select_from() 子 句 。 通 过 使 
用 select_from()， 我 们 可 以 用 指定 的 from 3-4] t SOLAlchemy 生成 的 整个 from FAJ 
( 见 示例 2-25). 
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示例 2-25 使 用 连接 查询 多 个 表 

columns = [orders.c.order id, users.c.username, users.c.phone, 
cookies.c.cookie name, line items.c.quantity, 
line items.c.extended cost] 

cookiemon orders = select(columns) 

cookiemon orders = cookiemon orders.select from(orders.join(users).join( @ 

line items).join(cookies)).where(users.c.username -- 
' cookiemon') 
result - connection.execute(cookiemon orders).fetchall() 
for row in result: 
print(row) 


0 请 注意 ， 这 里 ， 我 们 让 SQLAlchemy 把 关系 连接 用 作 from 子 句 。 





结果 如 下 : 


(u'1', u'cookiemon', u'111-111-1111', u'chocolate chip', 2, Decimal('1.00')) 
(u'1', u'cookiemon', u'111-111-1111', u'peanut butter', 12, Decimal('3.00')) 


我 们 得 到 如 下 SQL 1849: 


SELECT orders.order id, users.username, users.phone, cookies.cookie name, 
line items.quantity, line items.extended cost FROM users JOIN users ON 
users.user id - orders.user id JOIN line items ON orders.order id - 

line items.order id JOIN cookies ON cookies.cookie id = line items.cookie id 
WHERE users.username - :username 1 


此 外 ， 获 取 所 有 用 户 (包括 那些 当前 没有 订单 的 用 户 ) 的 订单 数量 也 很 有 用 。 为 此 ， 必 须 
使 用 outerjoinO 方法 ， 并 且 要 对 连接 顺序 多 加 注意 ， 因 为 应 用 outerjoinO 方法 的 表 会 
返回 所 有 结果 ( 见 示例 2-26), 


示例 2-26 使 用 外 连接 查询 多 个 表 
columns = [users.c.username, func.count(orders.c.order id)] 
all orders = select(columns) 
all orders = all orders.select from(users.outerjoin(orders)) © 
all orders = all orders.group by(users.c.username) 
result - connection.execute(all orders).fetchall() 
for row in result: 
print(row) 


© SQLAlchemy 知道 如 何 连 接 users 和 orders 表 ， 因 为 orders 表 中 定义 了 外 键 。 




















结果 如 下 : 


(u'cakeeater', 1) 

(u'cookiemon', 1) 

(u'pieguy', 0) 
ou ni I me 
(self-referential) 的 表 ， 比 如 员工 和 老板 的 关系 表 ， 该 怎么 办 呢 ? 为 了 便于 读 取 和 理解 ， 
SQLAlchemy 引入 了 别名 。 




















2.6 别名 


使 用 连接 时 ， 常 常 需要 多 次 引用 一 个 表 。 在 SQL 中 ， 这 是 通过 在 查询 中 使 用 别名 来 实现 
的 。 例 如 ， 假 设 我 们 有 下 面 一 个 (不 完整 的 ) 表 ， 它 用 来 描述 某 个 组 织 中 的 上 下 级 关系 : 

















employee table = Table( 
'employee', metadata, 
Column('id', Integer, primary key-True), 
Column('manager', None, ForeignKey('employee.id')), 
Column('name', String(255))) 














假设 现在 我 们 要 选择 由 Fred 管理 的 所 有 员工 。 在 SQL 中 ， 可 以 这 样 写 : 











SELECT employee.name 

FROM employee, employee AS manager 

WHERE employee.manager id - manager.id 
AND manager.name - 'Fred' 


在 这 种 情况 下 ，SQLAlchemy 允许 我 们 使 用 alias() 国 数 或 方法 来 实现 : 





>>> manager = employee table.alias('mgr') 
>>> stmt = select([employee table.c.name], 
and (employee table.c.manager id--manager.c.id, 
bis manager.c.name--'Fred')) 
>>> print(stmt) 
SELECT employee.name 
FROM employee, employee AS mgr 
WHERE employee.manager id - mgr.id AND mgr.name - ? 


SQLAlchemy if «TUA B Sie ESI, CRT DAE SS BLEU] 








: 


>>> manager = employee table.alias() 

>>> stmt = select([employee table.c.name], 
and_(employee_table.c.manager_id==manager.c.id, 

eek manager .c.name=='Fred')) 

>>> print(stmt) 

SELECT employee.name 

FROM employee, employee AS employee_1 

WHERE employee.manager id = employee 1.id AND employee 1.name = ? 


做 数据 报表 时 ， 对 数据 进行 分 组 很 有 用 。 接 下 来 学 习 如 何 对 数据 进行 分 组 。 


2.7 分 组 


使 用 分 组 时 ， 你 需要 一 个 或 多 个 列 来 做 分 组 ， 以 及 一 个 或 多 个 列 来 做 统计 ， 比 如 计数 、 求 和 
等 ， 就 像 在 普通 SQL 中 所 做 的 那样 。 下 面 ， 让 我 们 按 客户 获得 订单 数量 〈 见 示例 2-27). 
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示例 2-27 数据 分 组 
columns = [users.c.username, func.count(orders.c.order id)] © 
all orders = select(columns) 
all orders = all orders.select from(users.outerjoin(orders)) 
all orders = all orders.group by(users.c.username) @ 
result - connection.execute(all orders).fetchall() 
for row in result: 
print(row) 


9 使 用 count() 统计 订单 数 。 
o 根据 用 户 名 进行 分 组 。 


结果 如 下 : 





(u'cakeeater', 1) 
(u'cookiemon', 1) 
(u'pieguy', 0) 


在 前 面 的 例子 中 ， 构 建 语句 时 ， 我 们 已 经 用 过 生成 式 构建 方法 。 接 下 来 详细 讲 讲 。 


2.8 链 式 调用 


本 章 中 ， 我 们 已 经 多 次 用 过 链 式 调用 (chaining)， 只 是 没有 明说 。 构 建 查 询 时 ， 如 果 想 把 
逻辑 清晰 地 表达 出 来 ， 那 使 用 链 式 调用 会 特别 有 用 。 如 果 我 们 想 创建 一 个 函数 ， 让 其 为 我 
们 获取 订单 数据 ， 则 可 以 使 用 示例 2-28 所 示 的 代码 。 











示例 2-28 ” 链 式 调用 
def get orders by customer(cust name): 

columns = [orders.c.order id, users.c.username, users.c.phone, 
Cookies.c.cookie name, line items.c.quantity, 
line items.c.extended cost] 

cust orders - select(columns) 

cust orders - cust orders.select from( 

users.join(orders).join(line items).join(cookies)) 

cust orders = cust orders.where(users.c.username == cust name) 

result - connection.execute(cust orders).fetchall() 

return result 


get orders by customer('cakeeater') 
结果 如 下 : 


[(u'2', u'cakeeater', u'222-222-2222', u'chocolate chip', 24, Decimal('12.00')), 
(u'2', u'cakeeater', u'222-222-2222', u'oatmeal raisin', 6, Decimal('6.00'))] 





但 是 ， 如 果 只 想 获得 那些 已 经 发 货 或 者 还 没有 发 货 的 订单 ， 该 怎么 办 呢 ? 为 此 ， 必 须 编 写 
其 他 函数 来 支持 额外 的 过 滤 选 项 ， 或 者 使 用 条 件 来 构建 查询 链 。 另 外 ， 我 们 可 能 还 需要 一 
个 选项 ， 用 来 指定 是 否 包含 细 节 。 利 用 这 种 把 查询 和 子 句 链接 在 一 起 的 方法 ， 我 们 可 以 做 























^ 
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功能 强大 的 报表 ， 以 及 构建 出 复杂 的 查询 ( 见 示例 2-29), 


Er 


示例 2-29 ” 带 条 件 的 链 式 调用 


def get orders by customer(cust name, shipped=None, details-False): 
columns = [orders.c.order id, users.c.username, users.c.phone] 
joins = users.join(orders) 
if details: 
columns.extend([cookies.c.cookie name, line items.c.quantity, 
line items.c.extended cost]) 
joins = joins.join(line items).join(cookies) 
cust orders = select(columns) 
cust orders - cust orders.select from(joins) 


cust orders - cust orders.where(users.c.username -- cust name) 
if shipped is not None: 
cust orders = cust orders.where(orders.c.shipped == shipped) 


result - connection.execute(cust orders).fetchall() 
return result 


get orders by customer('cakeeater') @ 

get orders by customer('cakeeater', details-True) O 

get orders by customer('cakeeater', shipped-True) © 

get orders by customer('cakeeater', shipped-False) O 

get orders by customer('cakeeater', shipped-False, details-True) © 
@ 获取 所 有 订单 。 
@ 获取 所 有 订单 的 细 市 。 
e 只 获取 已 经 发 货 的 订单 。 
© 
© 





获取 还 没 发 货 的 订单 。 
获取 还 没 发 货 的 订单 细节 。 








结果 如 下 : 
[(u'2', u'cakeeater', u'222-222-2222')] 


[(u'2', u'cakeeater', u'222-222-2222', u'chocolate chip', 24, Decimal('12.00')), 
(u'2', u'cakeeater', u'222-222-2222', u'oatmeal raisin', 6, Decimal('6.00'))] 


[1 
[(u'2', u'cakeeater', u'222-222-2222')] 


[(u'2', u'cakeeater', u'222-222-2222', u'chocolate chip', 24, Decimal('12.00')), 
(u'2', u'cakeeater', u'222-222-2222', u'oatmeal raisin', 6, Decimal('6.00'))] 


到 目前 为 止 ， 我 们 在 所 有 示例 中 使 用 的 都 是 SQL 表达 式 语 言 。 或 许 ， 你 还 想 知道 SQLAlchemy 
是 否 也 支持 标准 的 SQL 语句 。 接 下 来 ， 让 我 们 了 解 一 下 。 
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2.9 原始 查询 


事实 上 ， 在 SQLAlchemyCore 中 ， 你 既 可 以 直接 执行 原始 的 SOL 语句 ， 也 可 以 将 其 作为 
SQLAlchemy Core 查询 的 一 部 分 使 用 。 它 们 返回 的 都 是 ResultProxy， 你 可 以 继续 与 它 交 
互 ， 就 像 使 用 SOLAlchemy Core 的 SQL 表达 式 语法 构建 的 查询 一 样 。 建 议 你 只 在 必要 的 
时 候 使 用 原始 查询 和 文本 ， 因 为 使 用 它们 有 可 能 带 来 不 可 预见 的 结果 和 安全 漏洞 。 首 先 ， 
让 我 们 尝试 执行 一 个 简单 的 select 语句 ( 见 示例 2-30). 








示例 2-30 ”完全 原始 的 查询 


result = connection.execute("select * from orders").fetchall() 
print(result) 


结果 如 下 : 
[(1, 1, 6), (2, 2, 6)] 


虽然 我 很 少 使 用 完全 原始 的 SQL 语句 ， 但 是 经 常 使 用 小 文本 片段 让 查询 变 得 更 清晰 。 示 例 
2-31 是 部 分 文本 查询 的 例子 ， 其 中 用 到 了 text() 函数 。 





示例 2-31 部 分 文本 查询 
from sqlalchemy import text 
stmt = select([users]).where(text("username='cookiemon'")) 
print(connection.execute(stmt).fetchall()) 


结果 如 下 : 


[(1, None, u'cookiemon', u'mon@cookie.com', u'111-111-1111', u'password ', 
datetime.datetime(2015, 3, 30, 13, 48, 25, 536450), 
datetime.datetime(2015, 3, 30, 13, 48, 25, 536457)) 

] 




















现在 ， 你 应 该 学 会 了 如 何 使 用 SQL 表达 式 语 言 处 理 SQLAlchemy 中 的 数据 。 这 一 章 ， 我 
们 学 习 了 创建 、 读 取 、 更 新 和 删除 等 操作 。 到 这 里 ， 你 可 以 停 一 停 ， 多 做 一 些 尝 试 ， 进 

步 了 解 一 下 相关 内 容 ， 然 后 再 往 下 学 。 比 如 尝试 创建 更 多 cookie、 订 单 和 行 项 目 ， 使 用 查 
询 链 按 订 单 和 用 户 进 行 分 组 。 当 你 对 本 章 内 容 有 了 更 深入 的 了 解 之 后 ， 就 可 以 继续 往 下 学 
习 新 内 容 了 。 接 下 来 ， 让 我 们 了 解 一 下 如 何 处 理 SQLAIchemy 抛 出 的 异常 ， 以 及 如 何 使 用 
事务 对 语句 进行 分 组 。 
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上 一 章 中 ， 做 数据 处 理 时 ， 大 都 只 用 一 个 语句 就 完成 了 ， 并 且 回 避 了 那些 有 可 能 导致 错误 
的 操作 。 在 本 章 中 ， 我 们 会 故意 执行 一 些 不 正确 的 操作 ， 以 便 了 解 有 哪些 错误 类 型 以 及 如 
何 处 理 它们 。 本 章 最 后 ， 我 们 还 会 学 习 如 何 把 需要 成 功 执行 的 语句 分 组 到 事务 中 ， 以 确保 
这 些 语 句 要 么 被 正确 执行 ， 要 么 被 正确 清理 掉 。 让 我 们 先 搞 点 破坏 ! 





3.1 异常 


SQLAlchemy 中 可 能 发 生 的 异常 有 和 很多， 我们 重点 讲 讲 最 常见 的 AttributeErrors 和 
AttributeErrors。 掌 握 了 这 些 常见 异常 的 处 理 方法 之 后 ， 相 信 对 于 那些 不 太 常 见 的 异常 你 
也 能 轻松 处 理 了 。 





为 了 学 习 本 章 ， 请 启动 一 个 新 的 Python shell， 并 把 在 第 1 章 创 建 的 表 加 载 进 去 。 示 例 3-1 
再 次 把 用 到 的 表 和 连接 列 了 出 来 ， 以 供 你 参考 。 








示例 3-1 构建 shell 环境 


from datetime import datetime 


from sqlalchemy import (MetaData, Table, Column, Integer, Numeric, String, 
DateTime, ForeignKey, Boolean, create engine, 
CheckConstraint) 

metadata - MetaData() 


cookies - Table('cookies', metadata, 


Column('cookie id', Integer(), primary key-True), 
Column('cookie name', String(50), index-True), 
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Column('cookie recipe url', String(255)), 
Column('cookie sku', String(55)), 

Column('quantity', Integer()), 

Column('unit cost', Numeric(12, 2)), 
CheckConstraint('quantity > 0', name='quantity_positive' ) 


) 


users = Table('users', metadata, 
Column('user id', Integer(), primary key-True), 
Column('username', String(15), nullable-False, unique-True), 
Column('email address', String(255), nullable-False), 
Column('phone', String(20), nullable-False), 
Column('password', String(25), nullable-False), 
Column('created on', DateTime(), default=datetime.now), 
Column('updated on', DateTime(), default=datetime.now, onupdate=datetime.now) 


) 


orders - Table('orders', metadata, 
Column('order id', Integer()), 
Column('user id', ForeignKey('users.user id')), 
Column('shipped', Boolean(), default-False) 


) 


line items - Table('line items', metadata, 
Column('line items id', Integer(), primary key-True), 
Column('order id', ForeignKey('orders.order id')), 
Column('cookie id', ForeignKey('cookies.cookie id')), 
Column('quantity', Integer()), 
Column('extended cost', Numeric(12, 2)) 


) 


engine = create engine('sqlite:///:memory:') 
metadata.create all(engine) 
connection - engine.connect() 


我 们 要 学 习 的 第 一 个 错误 是 AttributeError， 它 是 我 在 调试 代码 的 过 程 中 最 常 遇见 的 错误 。 


3.1.1 AttributeError 


我 们 从 AttributeError 学 起 。 当 试图 访问 一 个 不 存在 的 属性 时 ， 就 会 出 现 AttributeError 
这 个 错误 。 如 果 你 要 访问 的 列 在 ResultProxy 中 不 存在 ， 经 常会 出 现 AttributeError 错误 。 
试图 访问 一 个 对 象 中 不 存在 的 属性 时 ， 就 会 引发 AttributeError 错误 。 在 普通 Python 代 
码 中 ， 你 可 能 遇 到 过 这 个 错误 。 这 里 把 它 单独 拿 出 来 讲 是 因为 它 是 SQLAIchemy 中 一 个 党 
见 的 错误 ， 并 且 我 们 很 容易 忽略 它 发 生 的 原因 。 为 了 引发 这 个 错误 ， 我 们 先 向 users 表 中 
插入 一 条 记录 并 查询 它 。 然 后 ， 尝 试 访问 一 个 列 ， 这 个 列 在 users 表 中 存在 ， 但 在 查询 中 
不 存在 ( 见 示例 3-2)。 








WR] 



























































示例 3-2 5|% AttributeError 


from sqlalchemy import select, insert 
ins = insert(users).values( 





username="cookiemon", 
email_address="mon@cookie.com", 
phone="111-111-1111", 


password="password" 


) 


result = connection.execute(ins) © 


S = select([users.c.username]) 
results - connection.execute(s) 


for result in results: 


print(result.username) 
print(result.password) @ 


@ 插入 一 条 记录 供 测试 。 


e 查询 结果 中 不 存在 password 列 ， 因 为 我 们 只 查询 了 username 列 。 


示例 3-2 中 的 代码 导致 Python 


抛 出 一 个 AttributeError 并 停止 程序 的 执行 。 我 们 看 看 错误 


输出 ， 了 解 一 下 发 生 了 什么 〈 见 示例 3-3). 


示例 3-3 ”执行 示例 3-2 产生 的 错误 输出 


cookiemon 


AttributeError 


Traceback (most recent call last) @ 


«ipython-input-37-c4520631a10a» in <module>() 
3 for result in results: 
4 print(result.username) 

----> 5 print(result.password) € 


AttributeError: Could not locate column in row for column 'password' © 


X— Arte TR, H 


F 显 示 了 错误 跟踪 。 





0 
e 这 一 行 导致 了 错误 的 发 生 。 
e 这 是 我 们 需要 关注 的 部 分 。 





示例 3-3 呈现 的 是 Python 中 AttributeError 的 标准 格式 。 第 一 行 指 明 错 误 类 型 。 接 着 是 错 


误 跟踪 ， 指 出 错误 发 生 的 位 置 
以 它 就 把 实际 引发 错误 的 代码 


。 由 于 我 们 的 代码 试图 访问 查询 结果 中 一 个 不 存在 的 列 ， 所 
行 指 了 出 来 。 最 后 一 行 提 供 了 有 关 错 误 的 重要 细节 。 它 再 次 


指明 错误 类 型 以 及 发 生 错 误 的 原因 。 本 例 中 ， 引 发 AttributeError 的 原因 是 ResultProxy 


中 的 行 不 包含 password 列 ， 





因为 我 们 只 查询 了 用 户 名 。AttributeError 是 我 们 使 用 


SQLAlchemy 对 象 时 经 常会 遇 到 的 错误 。 此 外 ， 还 有 一 些 SQLAlchemy 特有 的 错误 ， 它 们 
大 都 是 由 于 错 用 SQLAlchemy 语句 引起 的 。 下 面 来 看 一 个 例子 : IntegrityError, 


3.1.2 IntegrityErr 


另 一 个 常见 的 SQLAIchemy £5 
事情 时 ， 就 会 发 生 这 种 错误 。 





or 


误 是 IntegrityError， 当 试图 做 一 些 违反 列 约束 或 表 约 束 的 
这 种 类 型 的 错误 通常 出 现在 你 的 操作 破坏 了 唯一 性 约束 的 情 
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形 下 。 比 如 ， 如 果 你 试图 创建 的 两 个 用 户 拥有 相同 的 用 户 名 ， 就 会 抛 出 IntegrityError, 











因为 users 表 中 的 用 户 名 必须 是 唯一 的 。 示 例 3-4 中 的 代码 会 引发 IntegrityError 错误 。 


示例 3-4 引发 IntegrityError 错误 


S = select([users.c.username]) 
connection.execute(s).fetchall() © 


[(u'cookiemon',)] 


ins = insert(users).values( 
username="cookiemon", 
email_address="damon@cookie.com", 
phone="111-111-1111", 
password="password" 


) 


result = connection.execute(ins) @ 


@ 查看 users 表 中 的 当前 记录 。 
@ 尝试 插入 第 二 条 记录 ， 这 会 导致 发 生 错误 。 








示例 3-4 中 的 代码 会 让 SOLAlchemy 产生 IntegrityError 错误 。 接 下 来 ， 让 我 们 看 看 错误 


输出 ， 并 了 解 一 下 发 生 IntegrityError 错误 的 原因 是 什么 〈 见 示例 3-5). 








示例 3-5 IntegrityError 错误 输出 


IntegrityError Traceback (most recent call last) 
«ipython-input-7-6ecafb68a8ab» in <module>() 

5 password="password" 

6 ) 
----> 7 result = connection.execute(ins) © 


. 0 


IntegrityError: (sqlite3.IntegrityError) UNIQUE constraint failed: 
users.username [SQL: u'INSERT INTO users (username, email_address, phone, 
password, created on, updated on) VALUES (?, ?, ?, ?, ?, ?)'] [parameters: 
('cookiemon', 'damon@cookie.com', '111-111-1111', 'password', 

'2015-04-26 10:52:24.275082', '2015-04-26 10:52:24.275099')] © 


O 这 行 触发 了 错误 。 
o 这 里 是 长 长 的 错误 跟踪 ， 我 省 略 了 。 
是 需要 我 们 关注 的 部 分 。 


3 


示例 3-5 展示 了 SQLAlchemy 中 IntegrityError 错误 的 标准 输出 格式 。 第 一 行 指 明了 错 
误 类 型 。 然 后 是 错误 跟踪 详情 。 不 过 ， 这 通常 只 是 我 们 的 执行 语句 和 内 部 SQLAlchemy 


代码 。 对 IntegrityError 错误 来 说 ， 我 们 通常 完全 可 以 忽略 这 些 详情 。 最 后 一 行 包含 
IntegrityError 错误 的 重要 细节 ， 它 再 次 指明 了 错误 类 型 ， 然 后 指出 是 什么 导致 了 这 
误 。 在 本 例 中 ， 导 致 错误 的 原因 是 : 








了 
个 错 





UNIQUE constraint failed: users.username 


这 说 明 users 表 中 的 username 列 有 唯一 性 约束 ， 而 我 们 的 操作 有 悖 于 它 。 然 后 ， 它 向 我 们 
提供 了 SQL 语句 以 及 编译 参数 的 详细 信息 ， 类 似 于 我 们 在 第 2 章 中 看 到 的 那样 。 由 于 这 个 
错误 ， 我 们 试图 插入 到 users 表 中 的 新 数据 没有 成 功 插入 。 这 个 错误 还 停止 了 程序 的 执行 。 
SQLAIchemy 中 还 有 许多 其 他 类 型 的 错误 ， 但 上 面 这 两 种 错误 是 最 常见 的 。SQLAlchemy 


中 所 有 错误 的 输出 格式 都 和 我 们 上 面 看 到 的 那 两 种 格式 一 样 。SQLAlchemy 文档 中 有 关于 
其 他 类 型 错误 的 信息 。 















































我 们 不 希望 程序 在 遇 到 错误 时 就 月 涡 ， 为 此 ， 我 们 还 要 学 习 如 何 正 确 地 处 理 错 误 。 





3.1.3 ”处 理 错误 

为 了 防止 错误 导致 程序 崩溃 或 停止 ,需要 正确 地 处 理 错误 。 我 们 可 以 像 处 理 Python 错误 一 
TE, fH try/except 块 。 比 如 ， 可 以 使 用 try/except 块 来 捕获 错误 并 把 错误 消息 打印 出 
来 ， 然 后 继续 执行 程序 的 其 余部 分 。 请 看 示例 3-6, 


示例 3-6 捕获 异常 

from sqlalchemy.exc import IntegrityError © 

ins = insert(users).values( 
username="cookiemon", 
email_address="damon@cookie.com", 
phone="111-111-1111", 
password="password" 

) 

try: 
result = connection.execute(ins) 

except IntegrityError as error: @ 
print(error.orig.message, error.params) 














© sqlalcheny.exc 模块 中 所 有 的 SQLAlchemy 异常 都 可 用 。 
O 捕获 IntegrityError 异常 ， 这 样 才 能 访问 这 个 异常 的 属性 。 








示例 3-6 中 的 语句 与 示例 3-4 一 样 ， 但 是 我 们 把 result = connection.execute(ins) 语句 放 
在 了 try/except 块 中 。 当 发 生 错 误 时 ，try/except 块 会 捕获 IntegrityError 并 把 错误 信 
息 和 语句 参数 打印 出 来 。 在 示例 3-6 中 ， 我 们 在 异常 子 句 中 打印 错误 消息 ， 但 其 实 我 们 
可 以 在 异常 子 句 中 编写 任何 我 们 喜欢 的 Python 代码 ， 比 如 在 其 中 向 用 户 返 回 一 条 错误 消 
息 ， 告 知 程序 运行 出 现 了 故障 。 通 过 使 用 try/except 块 处 理 错误 ， 可 以 让 应 用 程序 继续 运 
行 下 去 。 


















































虽然 示例 3-6 演 示 的 是 IntegrityError 错误 的 处 理 方法 ， 但 是 这 种 处 理 方法 对 
SQLAlchemy 产生 的 各 种 类 型 的 错误 都 有 效 。 有 关 其 他 SOLAlchemy 异常 的 更 多 信息 ， 请 
参阅 SQLAlchemy 文档 。 











请 注意 ，try/except 块 中 的 代码 越 少 越 好 ， 并 且 只 用 它 来 捕获 特定 类 型 的 错 
误 。 这 样 做 可 以 防止 捕获 一 些 意 料 之 外 的 错误 ， 而 这 些 错误 和 你 要 捕获 的 特 
定 错误 有 不 同 的 处 理 方式 。 














虽然 可 以 使 用 传统 的 Python 方法 处 理 单个 语句 的 异常 ， 但 是 如 果 有 多 个 数据 库 语 句 ， 并 且 
它们 之 间 相 互 依赖 ， 那 传统 方法 可 能 就 不 适用 了 。 在 这 种 情况 下 ， 需 要 把 这 些 语句 包装 在 
一 个 数据 库 事 务 中 。 为 此 ，SQLAlchemy 提供 了 一 个 简单 易 用 的 包装 器 一 一 事务 ， 它 内 置 
于 连接 对 象 中 。 


3.2 事务 


我 们 不 需要 学 习 事 务 背 后 高 深 的 数据 库 理 论 ， 只 要 把 它 看 成 一 种 打包 方法 就 好 。 通 过 事 
Z, 我 们 可 以 把 多 个 数据 库 语 句 打包 成 一 组 ， 作 为 一 个 整体 ， 这 组 语句 执行 时 要 么 成 功 要 
么 失败 。 启 动 事务 时 ， 数 据 库 系 统 会 先 记录 数据 库 的 当前 状态 ， 然 后 再 执行 多 个 SQL 语 
句 。 如 果 事 务 中 的 所 有 SQL 语句 都 成 功 执行 ， 那 么 数据 库 将 继续 正常 运行 ， 并 丢弃 之 前 的 
数据 库 状态 。 图 3-1 描述 了 正常 的 事务 流程 。 
























































图 3-1: 正常 的 事务 流程 


然而 ， 只 要 事务 中 有 一 个 或 多 个 语句 执行 失败 ， 我 们 就 会 捕获 错误 ， 并 回 深 到 先前 的 状 
态 。 图 3-2 描述 了 事务 失败 时 的 处 理 流程 。 
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事务 回 党 























3-2: 事务 失败 时 的 流程 


下 面 举 例 说 明 一 下 什么 时 候 需 要 在 当前 数据 库 中 这 样 做 。 当 一 位 客户 跟 我 们 订购 了 cookie 
之 后 ， 我 们 需要 把 指定 的 cookie 发 送 给 客户 ， 然 后 从 库存 中 删除 。 但 是 ， 如 果 我 们 没有 足 
够 的 cookie 来 完成 这 笔 订 单 呢 ? 这 时 ， 我 们 需要 先 查 看 库存 ， 而 不 是 执行 订单 。 可 以 使 用 


事务 来 解决 这 个 问题 。 


我 们 需要 新 开 一 个 Python shell， 创 建 一 些 数 据 表 。 这 里 用 到 的 表 和 第 2 章 中 差不多 ， 但 
是 ， 我 们 要 向 quantity 列 添加 CheckConstraint， 这 样 可 以 确保 数量 不 会 小 于 0， 因 为 库 
存 中 的 cookie 不 可 能 是 负数 。 接 下 来 ， 重 新 创建 cookiemon 用 户 以 及 chocolate chip cookie 
和 dark chocolate chip cookie 记录 。 把 chocolate chip cookie 的 数量 设置 为 12 块 ， 把 dark 
chocolate chip cookie 的 数量 设置 为 1 块 。 示例 3-7 显示 了 创建 带 有 CheckConstraint 的 数 
据 表 、 添 加 cookiemon 用 户 和 添加 cookie 的 完整 代码 。 


示例 3-7 准备 事务 环境 


from datetime import datetime 
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from sqlalchemy import (MetaData, Table, Column, Integer, Numeric, String, 
DateTime, ForeignKey, Boolean, create engine, 
CheckConstraint) 

metadata - MetaData() 


cookies - Table('cookies', metadata, 
Column('cookie id', Integer(), primary key-True), 
Column('cookie name', String(50), index-True), 
Column('cookie recipe url', String(255)), 
Column('cookie sku', String(55)), 
Column('quantity', Integer()), 
Column('unit cost', Numeric(12, 2)), 
CheckConstraint('quantity >= 0', name-'quantity positive') 








users - Table('users', metadata, 
Column('user id', Integer(), primary key-True), 
Column('username', String(15), nullable-False, unique-True), 
Column('email address', String(255), nullable-False), 
Column('phone', String(20), nullable-False), 
Column('password', String(25), nullable-False), 
Column('created on', DateTime(), default-datetime.now), 
Column('updated on', DateTime(), default=datetime.now, onupdate-datetime.now) 


) 


orders - Table('orders', metadata, 
Column('order id', Integer()), 
Column('user id', ForeignKey('users.user id')), 
Column('shipped', Boolean(), default-False) 

) 


line items - Table('line items', metadata, 
Column('line items id', Integer(), primary key-True), 
Column('order id', ForeignKey('orders.order id')), 
Column('cookie id', ForeignKey('cookies.cookie id')), 
Column('quantity', Integer()), 
Column('extended cost', Numeric(12, 2)) 


) 


engine - create engine('sqlite:///:memory:') 

metadata.create all(engine) 

connection - engine.connect() 

from sqlalchemy import select, insert, update 

ins = insert(users).values( 
username="cookiemon", 
email_address="mon@cookie.com", 
phone="111-111-1111", 
password="password" 

) 

result = connection.execute(ins) 

ins = cookies.insert() 

inventory list = [ 


{ 
'cookie name': ‘chocolate chip', 
'cookie recipe url': 'http://some.aweso.me/cookie/recipe.html', 
'cookie sku': 'CC01', 
'quantity': '12', 
'unit cost': '0.50' 
}, 
{ 
'cookie name': 'dark chocolate chip', 
'cookie recipe url': 'http://some.aweso.me/cookie/recipe dark.html', 
'cookie sku': 'CC02', 
'quantity': '1', 
'unit cost': '0.75' 
} 


] 


result = connection.execute(ins, inventory list) 





BE RHR, Al cookiemon 用 户 定义 两 个 订单 。 第 一 个 订单 是 9 块 chocolate chip cookie, 55 — 
个 订单 是 4 块 chocolate chip cookie 和 1 块 dark chocolate chip cookie。 我 们 使 用 上 一 章 中 学 
习 的 insert 语句 来 完成 这 个 任务 。 示 例 3-8 是 添加 订单 的 代码 。 





示例 3-8 ”添加 订单 





ins = insert(orders).values(user id-1, order id-'1') 


result = connection.execute(ins) 
ins = insert(line items) 
order_items = [ 


{ 
‘order_id': 1, 
'cookie id': 1, 
'quantity': 9, 
'extended cost': 4.50 
} 


] 


result = connection.execute(ins, order_items) @ 


ins = insert(orders).values(user_id=1, order_id='2') 


result = connection.execute(ins) 
ins = insert(line items) 
order_items = [ 


{ 
'order id': 2, 
'cookie id': 1, 
'quantity': 4, 
'extended cost': 1.50 
}, 
{ 
‘order_id': 2, 
'cookie id': 2, 
'quantity': 1, 
'extended cost': 4.50 
} 


] 


result = connection.execute(ins, order_items) @ 


© 添加 第 一 个 订单 。 
e 添加 第 二 个 订单 。 














有 了 这 些 订 单数 据 ， 我 们 就 可 以 探索 事务 的 工作 原理 了 。 我 们 需要 定义 一 个 名 为 ship it 











的 函数 。 这 个 函数 接受 一 个 order_id 参数 ， 它 会 从 库存 中 删除 cookie， 并 把 订单 标记 为 


“CRE”. aD 3-9 是 ship it 函数 的 定义 代码 。 


示例 3-9 定义 ship_it() 函数 
def ship it(order id): 








S - select([line items.c.cookie id, line items.c.quantity]) 
S = s.where(line items.c.order id == order id) 


cookies to ship = connection.execute(s) 








for cookie in cookies to ship: © 
u = update(cookies).where(cookies.c.cookie id--cookie.cookie id) 
u = u.values(quantity = cookies.c.quantity - cookie.quantity) 
result = connection.execute(u) 

u = update(orders).where(orders.c.order id == order id) 

u = u.values(shipped-True) 

result - connection.execute(u) O 

print("Shipped order ID: {}".format(order_id)) 





@ 对 于 订单 中 的 每 种 cookie， 我 们 都 会 从 相应 cookies 表 的 quantity 列 中 删除 订单 指定 
的 数量 ， 这 样 就 可 以 知道 还 剩 下 多 少 。 
o 更 新 订单 ， 将 其 标记 为 “已 发 货 ”。 














每 当 发 出 一 个 订单 ，ship_it 函数 就 会 执行 所 有 必需 的 操作 。 我 们 对 第 一 个 订单 运行 这 个 函 
数 ， 然 后 查询 cookies 表 ， 确 保 它 正确 地 减少 了 cookie 的 数量 。 示 例 3-10 展示 了 具体 做 法 。 





示例 3-10 ”对 第 一 个 订单 运行 ship it 函数 
ship it(1) © 
S = select([cookies.c.cookie name, cookies.c.quantity]) 
connection.execute(s).fetchall() @ 


@ 对 第 一 个 order_id 运行 ship it 国 数 。 
@ 查 看 库存 。 
示例 3-10 的 运行 结果 如 下 : 
[(u'chocolate chip', 3), (u'dark chocolate chip', 1)] 


太 好 了 ! ship_it 函数 工作 正常 。 从 执行 结果 中 可 以 看 到 ， 库 存 中 没有 足够 的 cookie 来 完 
成 第 二 个 订单 。 不 过 ， 在 工作 市 奏 很 快 的 仓库 中 ， 这 两 个 订单 可 能 会 被 同时 处 理 。 现 在 党 
试 使 用 ship it 函数 处 理 第 二 个 订单 ， 并 观察 会 发 生 什 么 (如 示例 3-11 所 示 )。 




















示例 3-11 对 第 二 个 订单 运行 ship_it 函数 


ship_it(2) 
结果 如 下 : 
IntegrityError Traceback (most recent call last) 


<ipython-input-9-47771be6653b> in <module>() 
----» 1 ship it(2) 


«ipython-input-6-301c0ed7c4a1» in ship it(order id) 


7 u - update(cookies).where(cookies.c.cookie id--cookie.cookie id) 

8 u = u.values(quantity = cookies.c.quantity-cookie.quantity) 
----> 9 result = connection.execute(u) 

10 - update(orders).where(orders.c.order id -- order id) 

11 - u.values(shipped-True) 





IntegrityError: (sqlite3.IntegrityError) CHECK constraint failed: 
quantiuty positive 

[SQL: u'UPDATE cookies SET quantity-(cookies.quantity - ?) WHERE 
cookies.cookie id - ?'] [parameters: (4, 1)] 


由 于 我 们 没有 是 够 的 chocolate chip cookie 来 完成 订单 ， 所 以 得 到 了 一 个 IntegrityError 错 
误 。 接 下 来 使 用 示例 3-10 中 的 最 后 两 行 代 码 看 看 cookies 表 发 生 了 什么 变化 : 





[(u'chocolate chip', 3), (u'dark chocolate chip', 0)] 


由 于 IntegrityError ffi, ship it 函数 没有 去 掉 chocolate chip cookie， 而 是 去 掉 了 dark 
chocolate chip cookie。 这 是 不 对 的 ! 我 们 想 向 客户 交付 完整 的 订单 ， 而 不 是 订单 的 一 部 分 。 
运用 在 3.1.3 节 中 学 到 的 try/except 知识 ， 我 们 可 以 设计 出 一 个 复杂 的 except 方法 来 解决 
这 种 分 批发 货 问 题 。 但 是 ， 事 务 为 我 们 提供 了 一 种 更 好 的 方式 来 处 理 这 类 问题 。 














事务 是 通过 调用 连接 对 象 的 begin() 方法 启动 的 。 调 用 begin() 方法 会 返回 一 个 事务 对 
象 ， 我 们 可 以 用 它 来 控制 所 有 语句 的 结果 。 如 果 所 有 语句 都 成 功 执行 ， 就 调用 事务 对 象 的 
commit() 方法 来 提交 事务 。 否 则 ， 就 调用 事务 对 象 的 rollback) 方法 进行 回 滚 操 作 。 下 
面 重 写 ship it 函数 ， 使 用 事务 来 保证 语句 安全 地 执行 。 示 例 3-12 是 重 写 后 的 ship it 

















示例 3-12 事务 型 ship_it 
from sqlalchemy.exc import IntegrityError © 
def ship it(order id): 
S - select([line items.c.cookie id, line items.c.quantity]) 
S - s.where(line items.c.order id -- order id) 
transaction = connection.begin() @ 
cookies_to_ship = connection.execute(s).fetchall() © 


try: 
for cookie in cookies_to_ship: 
u = update(cookies).where(cookies.c.cookie id == cookie.cookie_id) 
u = u.values(quantity = cookies.c.quantity-cookie.quantity) 
result - connection.execute(u) 
u - update(orders).where(orders.c.order id -- order id) 
u = u.values(shipped-True) 


result - connection.execute(u) 
print("Shipped order ID: {}".format(order_id)) 
transaction.commit() @ 

except IntegrityError as error: 
transaction.rollback() © 
print(error) 

















Gr 


Q 导入 IntegrityError, [LL [EAE 
@ 局 动 事务 。 














O 获取 所 有 结果 ， 只 是 为 了 更 容易 地 跟踪 所 发 生 的 事 。 
O 若 无 错 误 发 生 ， 提 交 事 务 。 
O FARRE, MRFS. 


现在 让 我 们 把 chocolate chipcookie 的 数量 改 回 1: 





u = update(cookies).where(cookies.c.cookie name == "dark chocolate chip") 
u = u.values(quantity = 1) 
result = connection.execute(u) 


我 们 需要 对 第 二 个 订单 重新 运行 应 用 基于 事务 的 ship it 函数 。 程 序 不 会 因为 错误 而 停止 ， 
它 会 打印 错误 信息 ， 并 且 不 带 错 误 跟 踪 详 情 。 让 我 们 使 用 示例 3-10 中 的 代码 检查 一 下 库 
存 ， 确 保 它 不 会 因 发 送 一 部 分 cookie 而 搞 乱 库存 : 








[(u'chocolate chip', 3), (u'dark chocolate chip', 1)] 
KET! 我 们 的 事务 型 国 数 没有 搞 乱 库存 或 者 导致 应 用 程序 崩溃 。 我 们 也 不 需要 编写 大 量 


代码 以 便 手 动 回 深 到 之 前 的 状态 。 如 你 所 见 ， 事 务 在 这 种 情况 下 非常 有 用 ， 并 且 可 以 大 大 
减少 手动 编码 的 工作 量 。 














本 章 我 们 学 习 了 单行 语句 和 多 行 语 句 中 的 异常 处 理 方法 。 通 过 在 单行 语句 上 添加 普通 的 
try/except 块 ， 可 以 防止 应 用 程序 在 磁 到 数据 库 语 句 执行 错误 时 发 生 月 涡 。 我 们 还 学 习 了 
事务 如 何 有 助 于 避免 数据 库 不 一 致 问题 ， 以 及 在 一 组 语句 组 执行 失败 时 如 何 防止 程序 崩 
并。 下 一 章 中 ， 我 们 将 学 习 测 试 代码 的 方法 ， 以 便 确保 代码 的 行为 符合 我 们 的 预期 。 














第 4 章 


测试 





应 用 程序 测试 大 都 包括 单元 测试 和 功能 测试 两 部 分 。 但 是 ， 在 使 用 SQLAlchemy 做 单元 测 
试 时 ， 要 正确 地 模拟 一 条 查询 语句 或 者 一 个 模型 可 能 需要 做 很 多 工作 。 在 对 数据 库 做 功能 
测试 时 ， 这 些 工 作 通常 不 会 带 来 多 大 好 处 。 所 以 ， 一 般 人 们 会 为 能 在 单元 测试 期 间 轻 松 模 
拟 的 查询 创建 包装 器 ， 或 者 在 单元 测试 和 功能 测试 中 均 只 针对 数据 库 做 测试 。 我 个 人 比较 
喜欢 使 用 小 巧 的 包装 器 函数 ， 但 是 如 果 出 于 某 种 原因 使 得 这 样 做 没有 意义 ， 或 者 我 处 理 的 
是 遗留 代码 ， 那 我 会 选择 使 用 模拟 方法 。 


本 章 讲解 如 何 对 数据 库 做 功能 测试 ， 以 及 如 何 模拟 SQLAlchemy 查询 和 连接 。 


4.1 使 用 测试 数据 库 做 测试 


在 我 们 的 示例 应 用 程序 中 ， 有 一 个 app.py 文件 ， 它 包含 应 用 程序 逻辑 ， 还 有 一 个 db.py 文 
件 ， 它 包含 数据 库 表 和 连接 。 你 可 以 在 CH04/ 文件 夹 中 找到 这 些 文件 。 


应 用 程序 的 结构 会 对 测试 方式 产生 很 大 影响 。 在 db.py 文件 中 ， 你 可 以 看 到 我 们 的 数据 库 
是 通过 DataAccessLayer 类 建立 的 。 我 们 使 用 这 个 数据 访问 类 来 初始 化 数据 库 模 式 ， 并 随 
时 将 其 连接 到 引擎 。 在 与 SQLAlchemy 结合 使 用 的 Web 框架 中 ， 你 会 经 常 看 到 这 种 模式 。 
DataAccessLayer 类 初始 化 时 ，dal 变量 中 并 不 存在 引 警 和 和 连接。 示例 4-1 是 db.py 文件 的 
一 个 片段 。 




















示例 4-1 DataAccessLayer 类 


from datetime import datetime 
from sqlalchemy import (MetaData, Table, Column, Integer, Numeric, String, 
DateTime, ForeignKey, Boolean, create engine) 


45 


class DataAccessLayer: 
connection - None 


engine - None 


conn string - None 
metadata - MetaData() 
cookies = Table('cookies', 


)0 


metadata, 

Column('cookie id', Integer(), primary key-True), 
Column('cookie name', String(50), index-True), 
Column('cookie recipe url', String(255)), 
Column('cookie sku', String(55)), 
Column('quantity', Integer()), 

Column('unit cost', Numeric(12, 2)) 


def db init(self, conn string): O 
self.engine - create engine(conn string or self.conn string) 
self.metadata.create all(self.engine) 
self.connection = self.engine.connect() 


dal = DataAccessLayer() © 


@ 在 完整 的 文件 中 ,我 
在 使 用 这 些 表 。 

@ 这 提供 了 一 种 方法 ， 
© 这 创建 了 DataAccess 








们 创建 了 所 有 表 ， 而 不 只 是 cookies R, ME 1 章 开 始 我 们 就 一 直 


可 以 像 工 广 一样 使 用 特定 连接 字符 串 初 始 化 连接 。 
Layer 类 的 一 个 实例 ， 你 可 以 在 应 用 程序 中 导入 它 。 














接 下 来 ， 为 第 2 章 中 创建 的 get_orders_by_customer 函数 编写 测试 。 你 可 以 在 app.py 文件 


中 找到 这 个 函数 。 代 码 女 








0 示例 4-2 所 示 。 


示例 4-2 待 测试 的 app.py 


from db import dal 


from sqlalchemy.sql import select 


def get orders by customer(cust name, shipped=None, details-False): 


columns = [dal. 


orders.c.order_id, dal.users.c.username, dal.users.c.phone] 


joins = dal.users.join(dal.orders) @ 


if details: 


columns.extend([dal.cookies.c.cookie name, 


dal.line items.c.quantity, 
dal.line items.c.extended cost]) 


joins = joins. join(dal.line_items).join(dal.cookies) 


cust_orders = select(columns) 
cust orders = cust_orders.select_from( joins) .where( 
dal.users.c.username == cust_name) 


if shipped is not None: 
cust_orders = cust_orders.where(dal.orders.c.shipped == shipped) 





result - dal.connection.execute(cust orders).fetchall() 


O 这 是 DataAccessLayer 类 的 实例 ， 来 自 db.py 文件 。 
e 因为 数据 表 在 dal 对 象 中 ， 所 以 我 们 从 这 里 访问 它们 。 











下 面 看 看 get_orders_by_customer 国 数 的 各 种 使 用 方法 。 在 这 个 练习 中 ， 假 设 我 们 已 经 对 
函数 的 输入 进行 了 验证 ， 它 们 的 类 型 都 是 正确 的 。 不 过 ， 在 你 的 测试 中 ， 明 智 的 做 法 是 确 
保 你 使 用 的 数据 有 能 正常 工作 的 ， 也 有 可 能 会 引起 错误 的 。 下 面 是 函数 的 参数 及 其 可 能 的 
取 值 。 




















cust name 可 以 是 空 的 、 包 含有 效 客户 名 的 字符 串 ， 或 者 是 不 包含 有 效 客户 名 的 字符 串 。 
shipped 可 以 是 None、True 或 False。 
details 可 以 是 Ture gy, False, 


如 果 想 测试 所 有 可 能 的 组 合 ， 那 么 需要 18 ( 即 3* 3* 2) 个 测试 来 充分 测试 这 个 函数 。 


请 注意 不 要 测试 那些 属于 SQLAlchemy 基本 功能 的 代码 ， 因 为 
SQLAlchemy 本 身 已 经 做 了 大 量 良 好 的 测试 。 比 如 ， 我 们 不 会 测试 简单 的 
insert, select, delete 或 update 语句 ， 因 为 这 些 语句 已 经 在 SQLAlchemy 
项 目 中 测试 过 了 。 我 们 应 该 测试 代码 操作 的 内 容 ， 这 些 内 容 可 能 会 影响 
SQLAlchemy 语句 的 运行 方式 或 它 返回 的 结果 。 
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对 于 这 个 测试 示例 ， 我 们 会 使 用 内 置 的 unittest 模块 。 如 果 你 不 熟悉 这 个 模块 ， 也 不 必 
担心 ， 我 会 给 大 家 讲 讲 重点 内 容 。 首 先 ， 我 们 需要 编写 测试 类 ， 并 对 dal 的 连接 进行 初始 
化 。 为 此 ， 新 建 一 个 名 为 test app.py 的 文件 ， 代 码 如 例 4-3 所 示 。 

示例 4-3 ”编写 测试 


import unittest 
class TestApp(unittest.TestCase): @ 


@classmethod 
def setUpClass(cls): @ 
dal.db init('sqlite:///:memory:') © 


O unittest 需要 的 测试 类 继承 自 unittest.TestCase, 

@ 在 整个 测试 类 中 ，setUpClass 方法 只 执行 一 次 。 

e 这 行 会 初始 化 一 个 到 内 存 数据 库 的 连接 ， 用 来 做 测试 。 

接 下 来 需要 加 载 一 些 数据 ， 以 便 在 测试 期 间 使 用 。 这 里 不 再 给 出 完整 的 代码 ， 因 为 其 中 用 
到 的 插入 语句 和 第 2 章 中 使 用 的 差不多 ， 但 为 了 方便 使 用 DataAccessLayer ， 我 做 了 一 些 修 
改 。 你 可 以 在 db.py 文件 中 找到 完整 的 代码 。 当 数据 加 载 好 之 后 ， 就 可 以 动手 编写 一 些 测 
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试 了 。 我 们 会 把 这 些 测试 以 函数 的 形式 添加 到 TestApp 类 中 ， 如 示例 4-4 所 示 。 
示例 4-4 ”针对 空 用 户 名 的 前 6 个 测试 


def test orders by customer blank(self): Q9 
results = get orders by customer('') 
self.assertEqual(results, []) O 


def test orders by customer blank shipped(self): 
results - get orders by customer('', True) 
self.assertEqual(results, []) 


def test orders by customer blank notshipped(self): 
results - get orders by customer('', False) 
self.assertEqual(results, []) 


def test orders by customer blank details(self): 
results - get orders by customer('', details-True) 
self.assertEqual(results, []) 


def test orders by customer blank shipped details(self): 
results - get orders by customer('', True, True) 
self.assertEqual(results, []) 


def test orders by customer blank notshipped details(self): 
results - get orders by customer('', False, True) 
self.assertEqual(results, []) 


@ unittest 要 求 每 个 测试 都 以 test 打头 。 


@ unittest 使 用 assertEqual 来 验证 结果 是 否 符合 你 的 预期 。 由 于 没有 找到 用 户 ， 所 以 你 
会 得 到 一 个 空 列表 。 


现在 ， 把 测试 文件 保存 为 test_app.py， 然 后 使 用 如 下 命令 运行 单元 测试 : 


# python -m unittest test_app 


Ran 6 tests in 0.018s 


你 可 能 会 得 到 一 个 有 关 SQLite 和 decimal AWAY, ZIG CH, Aix 
在 我 们 的 例子 中 是 正常 的 。 之 所 以 会 发 出 警告 ， 是 因为 SQLite 中 没有 真正 
的 decimal 类 型 ， 而 SQLAlchemy 希望 你 知道 ， 从 SQLite 的 float 类 型 转换 
而 来 可 能 有 些 奇 怪 。 认 真 阅读 这 些 消息 是 明智 之 举 ， 因 为 在 生产 代码 中 ， 这 
些 信 息 通 常 能 为 你 指出 正确 的 做 事 方法 。 这 里 我 们 特意 触发 了 这 个 警告 ， 以 
便 让 你 看 看 它 的 样子 。 




















接 下 来 需要 加 载 一 些 数据 ， 并 确保 我 们 的 测试 仍然 有 效 。 同 样 ， 我 们 会 重用 第 2 章 中 的 
例子 ， 揪 入 相同 的 用 户 、 订 单 和 行 项 。 不 过 ， 这 次 我 们 会 把 数据 插入 工作 放 和 一 个 名 为 
prep db 的 函数 中 ， 这 样 就 可 以 在 测试 之 前 通过 调用 prep. db 这 个 函数 来 插入 数据 了 。 为 了 
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把 它 放 到 测试 装置 或 实用 程序 文件 中 。 


示例 4-5 ”插入 一 些 测试 数据 
def prep_db(): 

ins = dal.cookies.insert() 

dal.connection.execute(ins, cookie name-'dark chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe dark.html', 
cookie skuz'CC02', 
quantity-'1', 
unit cost-'0.75') 

inventory list - [ 


{ 
'cookie name': ‘peanut butter', 
'cookie recipe url': 'http://some.aweso.me/cookie/peanut.html', 
'cookie sku': 'PB01', 
'quantity': '24', 
'unit cost': '0.25' 
}, 
{ 
'cookie name': ‘oatmeal raisin’, 
'cookie recipe url': 'http://some.okay.me/cookie/raisin.html', 
'cookie sku': 'EWWO1', 
'quantity': '100', 
'unit cost': '1.00' 
} 


] 


dal.connection.execute(ins, inventory_list) 


customer list = [ 


{ 
'username': "cookiemon", 
'email address': "mon@cookie.com", 
'phone': "111-111-1111", 
'password': "password" 

}, 

{ 
'username': "cakeeater", 
'email address': "cakeeater@cake.com", 
'phone': "222-222-2222", 
'password': "password" 

}, 

{ 
'username': "pieguy", 
'email address': "guy(pie.com", 
'phone': "333-333-3333", 
'password': "password" 

} 


] 


ins = dal.users.insert() 

dal.connection.execute(ins, customer list) 

ins = insert(dal.orders).values(user id-1, order id-'wlk001') 
dal.connection.execute(ins) 


单 起 见 ， 我 把 这 个 函数 放 入 db.py 文件 中 (参见 示例 4-5)。 但 是 ， 在 真实 情况 下 ， 通 常 





测试 


49 


ins = insert(dal.line items) 
order items - [ 


{ 
'order id': 'wlk001', 
'cookie id': 1, 
'quantity': 2, 
'extended cost': 1.00 
}, 
{ 
'order id': 'wlk001', 
'cookie id': 3, 
'quantity': 12, 
'extended cost': 3.00 
} 


] 


dal.connection.execute(ins, order_items) 

ins = insert(dal.orders).values(user_id=2, order_id='01001') 
dal.connection.execute(ins) 

ins = insert(dal.line items) 

order_items = [ 


{ 
'order id': 'ol001', 
'cookie id': 1, 
'quantity': 24, 
'extended cost': 12.00 
IF 
{ 
'order id': 'ol001', 
'cookie id': 4, 
'quantity': 6, 
'extended cost': 6.00 
} 


] 


dal.connection.execute(ins, order_items) 





到 这 里 ，prep_db 函数 就 创建 好 了 。 现 在 可 以 在 test app.py 文件 的 setUpClass 方法 中 调用 


它 ， 把 数据 加 载 到 数据 库 ， 再 运行 测试 。setUpClass 方法 的 代码 如 下 : 


@classmethod 

def setUpClass(cls): 
dal.db init('sqlite:///:memory:') 
prep. db() 








接 下 来 ， 就 可 以 使 用 这 些 测试 数据 来 确保 我 们 的 函数 在 给 定 有 效用 户 名 时 执行 正确 的 操 


作 。 把 测试 以 函数 的 形式 添加 到 TestApp 类 中 ， 如 示例 4-6 所 示 。 
示例 4-6 测试 合法 用 户 


def test orders by customer(self): 
expected results - [(u'wlk001', u'cookiemon', u'111-111-1111')] 
results = get orders by customer('cookiemon') 
self.assertEqual(results, expected results) 





def test orders by customer shipped only(self): 
results - get orders by customer('cookiemon', True) 
self.assertEqual(results, []) 


def test orders by customer unshipped only(self): 
expected results - [(u'wlk001', u'cookiemon', u'111-111-1111')] 
results - get orders by customer('cookiemon', False) 
self.assertEqual(results, expected results) 


def test orders by customer with details(self): 
expected results - [ 
(u'wlk001', u'cookiemon', u'111-111-1111', u'dark chocolate chip', 
2, Decimal('1.00')), 
(u'wlk001', u'cookiemon', u'111-111-1111', u'oatmeal raisin', 
12, Decimal('3.00')) 
] 
results = get orders by customer('cookiemon', details-True) 
self.assertEqual(results, expected results) 


def test orders by customer shipped only with details(self): 
results - get orders by customer('cookiemon', True, True) 
self.assertEqual(results, []) 


def test orders by customer unshipped only details(self): 
expected results - [ 
(u'wlk001', u'cookiemon', u'111-111-1111', u'dark chocolate chip', 
2, Decimal('1.00')), 
(u'wlk001', u'cookiemon', u'111-111-1111', u'oatmeal raisin', 
12, Decimal('3.00')) 
] 
results = get orders by customer('cookiemon', False, True) 
self.assertEqual(results, expected_results) 





使 用 示例 4-6 中 的 测试 作为 指导 ， 你 能 完成 针对 不 同 用 户 (比如 cakeeater) 的 测试 吗 ? 能 
对 系统 中 不 存在 的 用 户 名 进行 测试 吗 ? 如 果 用 户 名 是 整数 而 不 是 字符 串 ， 结 果 会 怎样 ? 请 
将 你 的 测试 和 示例 代码 中 的 测试 进行 比较 ， 看 看 你 的 是 否 与 本 书 中 使 用 的 测试 相似 。 








到 这 里 ， 我 们 已 经 学 习 了 如 何在 功能 测试 中 使 用 SQLAlchemy 来 判断 一 个 函数 在 给 定数 据 
集 上 的 行为 是 否 与 预期 一 致 。 我 们 还 了 解 了 如 何 设 置 unittest 文件 ， 以 及 如 何 准备 要 在 测 
试 中 使 用 的 数据 库 。 接 下 来 ， 我 们 可 以 在 不 访问 数据 库 的 情况 下 进行 测试 了 。 














4.2 ”使 用 mock 


当 在 测试 环境 中 创建 测试 数据 库 没 有 意义 或 者 根本 不 可 行 时 ，mock 技术 会 派 上 大 用 场 。 
如 果 你 有 大 量 逻 辑 需要 对 查询 结果 进行 操作 ， 那 么 模拟 SOLAlchemy 代码 返回 你 想 要 的 值 
会 很 有 用 ， 这 样 你 就 可 以 只 测试 周边 逻辑 。 通 常 ， 当 要 模拟 查询 的 某 个 部 分 时 ， 我 仍然 会 
创建 内 存 数据 库 ， 但 是 我 不 会 向 其 中 加 载 任何 数据 ， 而 是 会 模拟 数据 库 连接 本 身 。 这 样 我 
可 以 控制 执行 和 获取 方法 返回 的 内 容 。 我 们 将 在 本 节 中 学 习 具 体 做 法 。 
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为 了 学 习 如 何在 测试 中 使 用 mock， 我 们 会 为 一 个 有 效用 户 做 一 次 测试 。 这 一 次 我 们 将 使 
用 强大 的 mock 库 来 控制 连接 返回 的 内 容 。 在 Python 3 中 ，mock 是 unittest 模块 的 一 部 
分 。 但 是 ， 如 果 你 使 用 的 是 Python 2， 那 么 需要 先 使 用 pip 来 安装 mock 库 ， 以 便 获 得 最 新 
的 功能 。 为 此 ， 可 以 使 用 以 下 命令 : 





























pip install mock 
安装 好 mock 库 后 ， 就 可 以 在 测试 中 使 用 它 了 。mock 有 一 个 patch() 函数 ， 它 允许 我 们 使 
用 一 个 可 以 在 测试 中 控制 的 MagicMock 替换 Python 文件 中 给 定 的 对 象 。MagicMock 是 一 个 
特殊 的 Python 对 象 ， 它 可 以 跟踪 自身 的 使 用 方式 ， 并 人 允许 我 们 根据 其 使 用 方式 来 定义 它 的 
行为 。 


首先 ， 需要 导入 mock 库 。 在 Python 2 中 ， 需 要 使 用 如 下 代码 : 





























import mock 





在 Python 3 中 ， 需 要 使 用 如 下 代码 : 


from unittest import mock 





导入 mock 库 之 后 ， 我 们 将 把 patch 方法 用 作 装 饰 器 来 替换 dal 对 象 的 连接 。 装 饰 器 函数 
用 来 包装 另外 一 个 函数 ， 并 可 改变 被 包装 国 数 的 行为 。 因 为 da 对 象 是 通过 名 称 导入 到 
app.py 文件 的 ， 所 以 我 们 需要 在 app 模块 中 包装 它 ， 然 后 将 其 作为 参数 传人 测试 函数 。 现 
在 我 们 已 经 有 了 一 个 mock 对 象 ， 接 下 来 就 可 以 为 execute 方法 设置 一 个 返回 值 了 ， 本 例 
中 应 该 是 什么 也 不 返回 ， 但 要 接 上 fetchall 方法 ， 它 的 返回 值 是 我 们 想 要 测试 的 数据 。 示 
例 4-7 给 出 了 使 用 mock 代替 da 对 象 所 需 的 代码 。 














示例 4-7 模拟 连接 测试 
import unittest 
from decimal import Decimal 


import mock 


from db import dal, prep_db 
from app import get orders by customer 


class TestApp(unittest.TestCase): 
cookie orders - [(u'wlk001', u'cookiemon', u'111-111-1111')] 
cookie details - [ 
(u'wlk001', u'cookiemon', u'111-111-1111', 
u'dark chocolate chip', 2, Decimal('1.00')), 
(u'wlk001', u'cookiemon', u'111-111-1111', 
u'oatmeal raisin', 12, Decimal('3.00')) 


] 


@mock.patch('app.dal.connection') © 
def test orders by customer(self, mock conn): @ 
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mock conn.execute.return value.fetchall.return value = self.cookie orders © 
results - get orders by customer('cookiemon') O 
self.assertEqual(results, self.cookie orders) 


o 使 用 mock 包装 app 模块 中 的 dal.connection, 
mock 以 mock, conn 的 形式 传 入 测试 函数 。 


© 把 execute 方 法 的 返回 值 设置 成 fetchall 方法 的 返回 值 ， 并 将 fetchall 方法 的 返回 值 
设置 为 self.cookie_order。 


@ 调用 测试 函数 ， 模 拟 dal.connection， 并 返回 上 一 步 设 置 的 返回 值 。 


© 






































你 可 以 看 到 ， 使 用 复杂 的 查询 或 ResuLtProxy (如 示例 4-7 所 示 ) 尝试 模拟 完整 的 查询 或 连 
接 时 ， 可 能 很 快 就 会 变 得 非常 乏味 。 但 不 要 因此 而 不 做 ， 这 对 于 发 现 未 知 bug 非常 有 用 。 














如 果 你 真 的 想 模拟 查询 ， 也 可 以 采用 相同 的 方法 ， 即 使 用 mock.patch 装饰 器 ， 并 模拟 app 模 
块 中 的 select 对 象 。 让 我 们 使 用 一 个 空 的 查询 尝试 测试 一 下 。 我 们 必须 模拟 所 有 查询 元 素 
的 返回 值 ， 在 这 个 查询 中 是 select, select from 和 where 子 句 。 示 例 4-8 演示 了 具体 做 法 。 

















示例 4-8 ”模拟 查询 

@mock.patch('app.select') @ 

@mock.patch('app.dal.connection' ) 

def test_orders_by_customer_blank(self, mock_conn, mock_select): @ 
mock select.return value.select from.return value.V 

where.return value = '' © 

mock conn.execute.return value.fetchall.return value - [] O 
results - get orders by customer('') 
self.assertEqual(results, []) 


O 查询 链 启动 时 ， 模 拟 select 方法 。 

e 按 顺序 把 装饰 器 传 到 函数 中 。 从 函数 顺 着 装饰 器 栈 向 上 ， 参 数 依 次 被 添加 到 左边 。 
e 我 们 必须 为 链 式 查询 的 所 有 部 分 模拟 返回 值 。 

@ 我 们 仍然 需要 模拟 连接 ， 否 则 app 模块 的 SQLAIchemy 代码 将 尝试 进行 查询 。 


希望 大 家 把 其 余 的 测试 作为 练习 ， 自 己 使 用 内 存 数据 库 和 模拟 测试 类 型 来 完成 它们 。 此 
外 ， 建 议 你 把 查询 和 连接 都 模拟 一 下 ， 这 样 你 会 对 整个 模拟 过 程 更 加 熟悉 。 











到 这 里 ， 你 应 该 已 经 熟悉 如 何 测 试 包 含 SQLAlchemy 函数 的 函数 。 你 还 学 会 了 如 何 把 数据 
预 填 充 到 测试 数据 库 中 ， 以 便 在 测试 中 使 用 。 最 后 ， 你 还 学 习 了 如 何 模拟 查询 对 象 和 连接 
对 象 。 本 章 中 举 的 例子 比较 简单 ， 我 们 将 在 第 14 章 中 深入 学 习 测 试 ， 届 时 会 涉及 Flask, 
Pyramid 和 pytest。 











接 下 来 ， 我 们 将 学 习 在 Python 中 如 何在 不 重建 所 有 模式 的 情形 下 ， 通 过 反射 使 用 
SQLAlchemy 处 理 现 有 数据 库 。 
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反射 





使 用 反射 技术 可 以 利用 现 有 数据 库 填 充 SQLAlchemy 对 象 。 你 可 以 运用 这 种 技术 反射 表 、 
视图 、 索 引 和 外 键 。 本 章 将 学 习 如 何在 示例 数据 库 上 使 用 反射 。 





为 了 测试 ， 我 建议 你 使 用 Chinook 数据 库 。 你 可 以 在 http://chinookdatabase.codeplex.com/ 
上 了 解 到 更 多 信息 。 这 里 ， 我 们 将 使 用 Chinook 数据 库 的 SQLite 版 本 ， 你 可 以 在 本 书 示例 
代码 的 CH05/ 文件 夹 中 找到 它 。 这 个 文件 夹 中 还 包含 一 张 数据 库 模式 图 像 ， 通 过 它 你 可 以 
清晰 地 了 解 本 章 中 使 用 的 模式 。 我 们 从 反射 单个 表 开始 学 起 。 


5.1 反射 单个 表 


在 第 一 个 反射 中 ， 我 们 将 生成 Artist 表 。 我 们 需要 一 个 元 数据 对 象 来 保存 被 反射 的 表 模 
式 信 息 ， 还 需要 一 个 引擎 来 连接 到 Chinook 数据 库 。 示 例 5-1 是 创建 元 数据 和 引擎 的 代码 ， 
这 些 代 码 你 现在 应 该 很 熟悉 了 。 








示例 5-1 创建 初始 对 象 
from sqlalchemy import MetaData, create engine 
metadata - MetaData() 
engine = create engine('sqlite:///Chinook Sqlite.sqlite') © 


@ 这 个 连接 字符 串 假 设 当前 文件 与 示例 数据 库 在 同一 个 目录 下 。 


当 创 建 好 元 数据 和 引擎 之 后 ， 我 们 就 有 了 反射 一 个 表 所 需要 的 一 切 。 接 下 来 ， 使 用 第 1 
章 中 的 表 创 建 代码 来 创建 一 个 表 对 象 。 但 是 ， 这 一 次 我 们 不 会 手动 定义 列 ， 而 会 使 用 
autoload 和 autoload with 这 两 个 关键 字 参 数 。 这 会 把 模式 信息 反射 到 metadata 对 象 中 ， 
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并 在 artist 变量 中 保存 对 表 的 引用 。 示 例 5-2 演示 了 如 何 做 反射 。 
示例 5-2 ”反射 Artist Ze 


from sqlalchemy import Table 
artist = Table('Artist', metadata, autoload=True, autoload_with=engine) 





最 后 一 行 就 是 反射 Artist 表 所 需 的 全 部 代码 ! 现在 我 们 就 可 以 使 用 这 个 表 了 ， 就 像 在 第 
2 章 中 使 用 手动 定义 的 表 一 样 。 示 例 5-3 展示 了 如 何 使 用 简单 的 表 查 询 来 查看 表 中 有 哪些 
数据 。 

示例 5-3 ”使 用 Artist X 


artist.columns.keys() @ 

from sqlalchemy import select 

S = select([artist]).limit(10) O 
engine.execute(s).fetchall() 

















0 显示 列 名 。 
e 查询 前 10 条 记录 。 





结果 如 下 : 
['ArtistId', 'Name'] 


[(1, u'AC/DC'), 

(2, u'Accept'), 

(3, u'Aerosmith'), 

(4, u'Alanis Morissette'), 
(5, u'Alice In Chains'), 

(6, u'António Carlos Jobim'), 
(7, u'Apocalyptica'), 

(8, u'Audioslave'), 

(9, u'BackBeat'), 

(10, u'Billy Cobham')] 








通过 查看 数据 库 模 式 ， 可 以 看 到 有 一 个 与 Artist 表 相 关联 的 ALbum 表 。 下 
来 反射 它 : 


下 用 相同 的 方法 














album = Table('Album', metadata, autoload-True, autoload_with=engine) 
接 下 来 查看 一 下 Albun 表 的 元 数据 ， 看 看 都 反射 了 些 什 么 ， 代 码 如 示例 5-4 所 示 。 
示例 5-4 查看 元 数据 


metadata.tables['album'] 


Table('album', 
MetaData(bind=None), 
Column('AlbumId', INTEGER(), table=<album>, primary_key=True, nullable-False), 
Column('Title', NVARCHAR(length-160), table=<album>, nullable-False), 
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Column('ArtistId', INTEGER(), table=<album>, nullable-False), 
schema=None) 


) 


需要 注意 的 是 ， 指 向 Artist 表 的 外 键 似 乎 并 没有 被 反射 。 让 我 们 查看 一 下 Album 表 的 
foreign keys 属性 ， 看 看 它 是 不 是 存在 : 


album.foreign keys 


set() 





从 这 个 结果 看 ， 外 键 的 确 没 有 被 反射 。 之 所 以 发 生 这 种 情况 ， 是 因为 这 两 个 表 不 是 同时 被 
反射 的 ， 而 且 在 反射 期 间 外 键 的 目标 不 存在 。 为 了 不 让 你 处 于 半 断 状态 ，SQLAlchemy 放 
弃 了 单 向 关系 。 可 以 使 用 第 1 章 中 学 到 的 知识 添加 缺失 的 ForeignKey， 从 而 恢复 它们 之 间 
的 关系 : 





from sqlalchemy import ForeignKeyConstraint 
album.append_constraint( 
ForeignKeyConstraint(['ArtistId'], ['artist.ArtistId']) 


) 
现在 ， 重 新 运行 示例 5-4， 你 会 看 到 Artistid 列 变 成 了 一 个 ForeignKey, 


Table('album', 

MetaData(bind=None), 

Column('AlbumId', INTEGER(), table=<album>, primary_key=True, 
nullable-False), 

Column('Title', NVARCHAR(length-160), table=<album>, nullable-False), 

Column('ArtistId', INTEGER(), ForeignKey('artist.ArtistId'), table=<album>, 
nullable-False), 

schema=None) 


接 下 来 看 看 是 否 可 以 使 用 这 个 关系 来 正确 地 连接 两 个 表 。 可 以 使 用 如 下 代码 测试 一 下 : 
str(artist.join(album)) 
'artist JOIN album ON artist."ArtistId" - album."ArtistId"' 


KAT! 现在 我 们 可 以 利用 这 种 关系 做 查询 了 ， 基 工作 方式 与 2.5 节 中 讨论 的 查询 一 样 。 





为 数据 库 中 的 每 个 表 重 复 这 样 的 反射 过 程 需要 花费 大 量 时 间 和 精力 。 不 过 ， 幸 运 的 是 ， 
SQLAlchemy 允许 我 们 一 次 反射 整个 数据 库 。 
5.2 反射 整个 数据 库 


为 了 反射 整个 数据 库 ， 可 以 使 用 metadata 对 象 的 reflect Hik, reflect 方法 会 扫描 引擎 
上 的 所 有 可 用 内 容 ， 并 反射 它 所 能 反射 的 所 有 内 容 。 下 面 ， 使 用 现 有 的 metadata 和 engine 











了 
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对 象 来 反射 整个 Chinook 数据 库 : 


metadata.reflect(bind=engine) 








如 果 这 条 语句 执行 成 功 ， 则 不 会 返回 任何 内 容 。 不 过 ， 可 以 运行 如 下 代码 来 获取 表 名 列 
表 ， 以 便 查看 metadata 都 反射 了 什么 : 





netadata.tables.keys() 


dict keys(['Invoiceline', 'Employee', 'Invoice', 'album', 'Genre', 
'PlaylistTrack', 'Album', 'Customer', 'MediaType', 'Artist', 
'Track', 'artist', 'Playlist']) 

















从 上 面 的 结果 可 以 看 到 ， 我 们 手动 反射 的 表 出 现 了 两 次 ， 但 它们 的 大 小 写 不 同 。 这 是 因为 
SQLAlchemy 根据 表 名 来 反射 表 ， 而 这 些 表 名 在 Chinook 数据 库 中 是 大 写 的 。 由 于 SQLite 
区 分 大 小 写 ， 所 以 小 写 和 大 写 名 称 指向 了 数据 库 中 相同 的 表 。 




















请 小 心 : 区 分 大 小 写 有 可 能 会 在 其 他 数据 库 〈 比 如 Oracle) 上 造成 错误 。 











至 此 ， 我 们 已 经 反射 了 整个 数据 库 。 接 下 来 讲 讲 如 何在 查询 中 使 用 那些 被 反射 的 表 。 


5.3 使 用 反射 对 象 构建 查询 


就 像 你 在 示例 5-3 中 看 到 的 那样 ， 对 于 我 们 反射 并 存储 在 变量 中 的 数据 表 ， 其 查询 方法 与 
第 2 章 中 一 样 。 但 是 ， 对 于 反射 整个 数据 库 时 所 反射 的 其 他 表 ， 我 们 需要 一 种 在 查询 中 引 
用 它们 的 方法 。 这 可 以 通过 把 它们 赋 给 metadata.tables 属性 的 一 个 变量 来 实现 ， 如 示例 
5-5 所 示 。 


示例 5-5 在 查询 中 使 用 反射 表 


playlist = metadata.tables['Playlist'] © 





from sqlalchemy import select 
S = select([playlist]).limit(10) @ 
engine.execute(s).fetchall() 


@ 创建 一 个 引用 Playlist 表 的 变量 playlist, 
e 在 查询 中 使 用 playlist 变量 。 


运行 示例 5-5 中 的 代码 ， 将 得 到 如 下 结果 : 


engine.execute(s).fetchall() 
[(1, 'Music'), 
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(2, 'Movies'), 

(3, 'TV Shows'), 

(4, 'Audiobooks'), 
(5, '90's Music'), 
(6, 'Audiobooks'), 
(7, 'Movies'), 

(8, 'Music'), 

(9, 'Music Videos'), 
(10, 'TV Shows')] 


我 们 把 想 要 使 用 的 反射 表 赋 给 一 个 变量 ， 然 后 就 可 以 使 用 前 几 章 中 学 到 的 方法 来 使 用 它 
们 了 。 

反射 是 一 个 非常 有 用 的 工具 。 然 而 ， 在 SQLAlchemy 1.0 版 本 中 ， 我 们 不 能 反射 CheckConstraint, 
注释 或 触发 器 。 你 也 不 能 反射 客户 端的 默认 值 ， 以 及 序列 与 列 之 间 的 关联 。 但 是 ， 可 以 使 
用 第 1 章 介 绍 的 方法 手动 添加 它们 。 








到 这 里 ， 相 信 你 已 经 学 会 如 何 反射 单个 表 ， 以 及 如 何 修复 这 些 表 中 缺失 的 关系 等 问题 。 此 
外 ， 你 还 学 会 了 如 何 反 射 整个 数据 库 ， 以 及 如 何在 查询 时 使 用 其 中 的 单个 表 。 








本 章 介 绍 了 SQLAlchemy Core 和 SQL 表达 式 语言 的 基本 内 容 。 希望 你 认识 到 了 
SQLAlchemy 功能 的 强大 。 相 比 于 SQLAlchemy ORM, SQLAlchemy Core 和 SQL 表达 式 
语言 经 常 被 忽略 ， 但 是 借助 它们 ， 我 们 可 以 为 应 用 程序 添加 更 多 功能 。 接 下 来 继续 学 习 有 
关 SQLAlchemy ORM 的 内 容 。 





第 二 部 分 
SQLAlchemy ORM 





提 到 SQLAlchemy 时 ， 大 多 数 人 首先 想到 的 是 SQLAlchemy ORM。 它 为 我 们 提供 了 一 种 
将 数据 库 模 式 和 操作 绑 定 到 应 用 程序 中 使 用 的 相同 的 数据 对 象 上 的 非常 有 效 的 方法 ， 还 提 
供 了 一 种 快速 构建 应 用 程序 并 交付 给 客户 的 方法 。ORM 使 用 起 来 非常 简单 ， 以 至 于 大 多 
数 人 都 不 曾 考 虑 其 代码 可 能 产生 的 副作用 。 思 考 你 的 代码 如 何 使 用 数据 库 仍然 很 重要 。 但 
Æ, ORM 的 奇妙 之 处 在 于 ， 你 可 以 只 在 需要 时 才 考 虑 这 一 点 ， 而 不 必 对 每 个 查询 都 这 样 
做 。 让 我 们 开始 使 用 ORM 吧 。 
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使 用 SQ 
R, ma 


后 声明 一 


使 用 SQLAIchemy 0RM 定 义 模 式 





LAlchemy ORM 时 ， 定 义 的 模式 会 略 有 不 同 ， 因 为 它 关 注 的 是 用 户 定义 的 数据 对 
FE 底层 数据 库 的 模式 。 在 SOLAlchemy Core 中 ， 我 们 会 先 创建 一 个 元 数据 容器 ， 然 
个 与 该 元 数据 相关 联 的 Table 对 象 。 而 在 SOLAlchemy ORM 中 ， 我 们 会 定义 一 

















个 类 ， 它 继承 自 一 个 名 为 declarative base 的 特殊 基 类 。dectLarative_base 把 元 数据 容器 
和 了 映射 器 (用 来 把 类 映射 到 数据 表 ) 结合 在 一 起 。 如 果 类 的 实例 已 经 保存 ，declarative_ 
base 还 会 把 类 的 实例 映射 到 表 中 的 记录 。 接 下 来 ， 让 我 们 深入 学 习 这 种 定义 表 的 方法 。 


6.1 


ORM 使 


。 继承 
。 包含 


。 包含 一 
。 确保 一 











使 用 DRM 类 定义 表 
用 的 类 应 该 满足 如 下 四 个 要 求 。 
自 declarative base 对 象 。 
. tablename _， 这 是 数据 库 中 使 用 的 表 名 。 
个 或 多 个 属性 ， 它 们 都 是 Column 对 象 。 
个 或 多 个 属性 组 成 主键 。 











我 们 需要 仔细 检查 最 后 两 个 与 属性 相关 的 需求 。 首 先 ， 在 ORM 类 中 定义 列 与 在 Table 对 
象 中 定义 列 非常 相似 ， 相 关内 容 已 经 在 第 2 章 中 讲 过 。 但 是 它们 之 间 有 一 个 非常 重要 的 区 
Bll, FE ORM 类 中 定义 列 时 ， 我 们 不 必 为 Column 构造 国 数 提供 列 名 作为 第 一 个 参数 。 相 





反 ， 我 人 








] 会 把 类 的 属性 名 赋 给 列 名 。 除 此 之 外 ，1.1 节 和 1.3.1 节 中 讲解 的 所 有 其 他 内 容 同 





样 适用 于 这 里 ， 并 且 能 够 按照 预期 工作 。 其 次 ， 对 主键 的 要 求 乍 看 有 点 怪 , 但 是 ，ORM 











需要 使 用 


它 来 唯一 地 标识 类 的 实例 ， 并 将 其 与 底层 数据 库 表 中 的 特定 记录 关联 起 来 。 下 面 
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看 看 定义 成 ORM 类 的 cookies $ ( 见 示例 6-1). 
示例 6-1 定义 成 ORM 类 的 Cookies X 


from sqlalchemy import Table, Column, Integer, Numeric, String 
from sqlalchemy.ext.declarative import declarative base 


Base = declarative base() @ 


class Cookie(Base): @ 
__tablename__ = 'cookies' © 


cookie_id = Column(Integer(), primary_key=True) @ 
cookie_name = Column(String(50), index=True) 
cookie recipe url = Column(String(255)) 

cookie sku = Column(String(55)) 

quantity = Column(Integer()) 

unit cost - Column(Numeric(12, 2)) 


创建 declarative base 类 的 一 个 实例 。 
继承 Base。 
定义 表 名 。 


o 
e 
e 
@ 定义 一 个 属性 ， 并 将 其 设置 为 主键 。 





上 面 代码 得 到 的 表 和 示例 2-1 中 的 表 一 样 ， 可 以 通过 查看 Cookie. table 属性 来 验证 这 
一 点 : 





>>> Cookie. table _ 

Table('cookies', MetaData(bind-None), 
Column('cookie id', Integer(), table=<cookies>, primary key-True, 

nullable-False), 

Column('cookie name', String(length-50), table=<cookies>), 
Column('cookie recipe url', String(length-255), table=<cookies>), 
Column('cookie sku', String(length-55), table=<cookies>), 
Column('quantity', Integer(), table=<cookies>), 
Column('unit cost', Numeric(precision-12, scale-2), 
table=<cookies>), schema=None) 











接 下 来 再 看 一 个 例子 。 这 次 我 想 根据 示例 2-2 重新 创建 users 表 。 示 例 6-2 演示 了 附加 关 
BESTE ORM 和 Core 模式 中 的 使 用 方式 是 一 样 的 。 


示例 6-2 另 一 个 拥有 更 多 列 的 表 


from datetime import datetime 
from sqlalchemy import DateTime 














T 


class User(Base): 
. tablename  - 'users' 


user id = Column(Integer(), primary key-True) 
username = Column(String(15), nullable=False, unique-True) © 





email address - Column(String(255), nullable-False) 

phone = Column(String(20), nullable-False) 

password = Column(String(25), nullable-False) 

created on = Column(DateTime(), default-datetime.now) @ 

updated on = Column(DateTime(), default-datetime.now, onupdate-datetime.now) © 


@ 这 里 ， 我 们 把 该 列 设置 为 “必需 ”(nutllable=False)， 并 要 求 其 值 是 唯一 的 。 
e 如 果 没 有 指定 日 期 ， 则 默认 将 此 列 设置 为 当前 时 间 。 
© 通过 使 用 onupdate， 使 得 每 次 更 新 记录 时 都 将 此 列 重 置 为 当前 时 间 。 


键 、 约 束 、 索 引 

1..2 节 中 讲 到 ， 除 了 在 列 本 身 中 定义 键 和 约束 之 外 ， 还 可 以 在 表 构 造 函 数 中 定义 键 和 约 
束 。 但 是 ， 使 用 ORM 时 ， 我 们 是 在 构建 类 ， 而 不 是 使 用 表 构 造 函 数 。 在 ORM 中 ， 可 以 
通过 类 的 __table_args_ 属性 来 添加 它们 。__table_args__ 接收 一 个 元 组 ， 里 面包 含 多 个 
表 参 数 ， 如 下 所 示 : 




















class SomeDataClass(Base): 
__tablename__ = 'somedatatable' 
. table args . = (ForeignKeyConstraint(['id'], ['other table.id']), 
CheckConstraint(unit cost »- 0.00', 
name-'unit cost positive')) 








从 上 面 的 代码 看 出 ， 其 语法 与 我 们 在 Table) 构造 函数 中 使 用 的 相同 。 这 也 适用 于 你 在 
1.3.3 节 中 学 到 的 内 容 。 


在 本 节 中 ， 我 们 学 习 了 如 何 使 用 ORM 定义 两 个 表 及 其 模式 。 定 义 数 据 模型 的 另 一 个 重要 
部 分 是 在 多 个 表 和 对 象 之 间 建立 关系 。 


6.2 关系 


SQLAIchemy Core 和 SQLAlchemy ORM 的 不 同 还 体现 在 表 和 对 和 象 的 关联 上 。ORM 使 用 类 
似 的 ForeignKey 列 来 约束 和 链接 对 象 。 但 是 ， 它 还 使 用 relationship 指令 来 提供 一 个 属 
性 ， 该 属性 可 用 于 访问 相关 对 象 。 这 在 使 用 ORM 时 的 确 会 增加 对 数据 库 的 使 用 和 开销 。 
但 是 ， 这 种 功能 带 来 的 好 处 远 远 多 于 缺点 。 我 很 想 为 你 提供 一 个 额外 开销 的 粗略 估计 值 ， 
但 这 个 值 会 因 你 的 数据 模型 和 模型 的 使 用 方式 而 不 同 。 在 大 多 数 情况 下 ， 这 个 值 甚至 不 值 
得 考虑 。 示 例 6-3 演示 了 如 何 使 用 relationship 和 backref 方法 定义 一 个 关系 。 


示例 6-3” 带 关系 的 表 
from sqlalchemy import ForeignKey 
from sqlalchemy.orm import relationship, backref @ 
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class Order(Base): 
. tablename  - 'orders' 


order id = Column(Integer(), primary key-True) 
user id - Column(Integer(), ForeignKey('users.user id')) O 
shipped - Column(Boolean(), default-False) 


user = relationship("User", backref-backref('orders', order by-id)) © 


o 请 注意 ， 我 们 是 如 何 从 sqLaLchem.orm 中 导入 relationship 和 backref 方法 的 。 
@ 定义 一 个 ForeignKey， 就 像 我 们 在 SQLAlchemy Core 中 所 做 的 那样 。 
e 这 建立 了 一 对 多 的 关系 。 





从 Order 类 中 定义 的 用 户 关系 可 以 看 出 ， 它 与 User 类 建立 了 一 对 多 的 关系 。 可 以 通过 访 
[a] user 属性 来 获得 与 此 Order 相关 的 User。 这 种 关系 还 通过 backref 关键 字 参 数 在 User 
eee orders 属性 ，backref 参数 按照 order id 排序 。 我 们 需要 为 relationship 提 

个 目标 类 ， 用 来 建立 关系 。 你 也 可 以 向 目标 类 添加 一 个 反 向 引用 。SQLAIlchemy 知 
ic ay ais ForeignKey 来 匹配 我 们 在 关系 中 定义 的 类 。 在 前 面 的 示例 中 ， 
ForeignKey(users.user id) (拥有 users 表 的 user_id 列 ) 通过 users 和 的 _tablename JE 
性 映射 到 User 类 ， 从 而 形成 关系 。 





























还 可 以 建立 一 对 一 的 关系 。 在 示例 6-4 中 ，LineIten 类 与 Cookie 类 就 是 一 对 一 的 关系 。 定 
义 一 对 一 的 关系 时 ， 我 们 用 到 了 uselist=False 这 个 关键 字 参 数 。 我 们 还 使 用 了 一 个 更 简 
单 的 反 向 引用 ， 因 为 我 们 不 想 控制 顺序 。 


示例 6-4 HAKAN ESR 
class LineItems(Base): 
__tablename__ = 'line items' 








line items id = Column(Integer(), primary key-True) 

order id = Column(Integer(), ForeignKey('orders.order id')) 
cookie id = Column(Integer(), ForeignKey('cookies.cookie id')) 
quantity = Column(Integer()) 

extended cost - Column(Numeric(12, 2)) 


order = relationship("Order", backref-backref('line items', 
order by-line items id)) 


cookie = relationship("Cookie", uselist-False) @ 
@ 这 里 形成 了 一 对 一 的 关系 。 


这 两 个 例子 是 学 习 关系 的 一 个 良好 的 起 点 。 不 过 ， 关 系 是 ORM 中 非常 强大 的 一 部 分 。 这 
里 只 是 做 了 简单 介绍 ， 第 14 章 会 进一步 学 习 相 关内 容 。 在 定义 完 所 有 类 并 建立 好 关系 之 
后 ， 就 可 以 在 数据 库 中 创建 表 了 。 


























6.3 模式 持久 化 


为 了 创建 数据 库 表 ， 我 们 会 用 到 Base 实例 中 metadata 的 create a0 方法 。 这 个 方法 需要 


一 个 引擎 实例 ， 与 SQLAlchemy Core 中 一 样 : 





from sqlalchemy import create engine 
engine = create engine('sqlite:///:memory:') 


Base.metadata.create all(engine) 





在 学 习 如 何 通过 ORM 处 理 类 和 表 








RUHR 








i 的 内 容 。 





之 前 ， 需 要 先 了 解 在 ORM 中 是 如 何 使 用 会 话 的。 下 一 





使 
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使 用 SQLAIchemy 0RM 处 理 数 所 




















我 们 已 经 定义 好 了 表示 数据 库 表 的 类 并 进行 了 持久 化 ， 接 下 来 开始 使 用 这 些 类 来 处 理 数 
据 。 本 章 将 讲解 如 何 插入 、 检 索 、 更 新 和 删除 数据 ， 还 会 学 习 如 何 对 数据 进行 排序 和 分 
组 ， 并 了 解 关 系 是 如 何 工作 的 。 我 们 先 从 SOLAlchemy 会 话 开 始 学 起 ， 它 是 SOLAlchemy 
ORM 最 重要 的 部 分 之 一 。 


7.1 会 话 

会 话 是 SQLAlchemy ORM 和 数据 库 交 互 的 方式 。 它 通过 引 敬 包装 数据 库 连 接 ， 并 为 通 
过 会 话 加 载 或 与 会 话 关联 的 对 象 提供 标识 映射 (identity map)。 标 识 映 射 是 一 种 类 似 于 
缓存 的 数据 结构 ， 它 包含 由 对 象 表 和 主键 确定 的 一 个 唯一 的 对 象 列表 。 会 话 还 包装 了 一 
个 事务 ， 这 个 事务 将 一 直 保 持 打 开 状 态 ， 直 到 会 话 提交 或 回 深 ， 这 与 3.2 节 中 描述 的 过 
程 很 相似 。 


























为 了 创建 新 会 话 ，SQLAlchemy 提供 了 sesstonmaker 类 ， 这 个 类 可 以 确保 在 整个 应 用 程序 
中 能 够 使 用 相同 的 参数 创建 会 话 。sessionmaker 类 通过 创建 一 个 Session 类 来 实现 这 一 点 ， 
Session 类 是 根据 传递 给 sessionmaker 工厂 的 参数 配置 的 。sessionmaker 工厂 在 应 用 程序 
全 局 作用 域 中 应 该 只 使 用 一 次 ， 并 且 被 视 为 配置 设置 。 下 面 创建 一 个 与 内 存 中 的 SQLite 数 
据 库 相 关联 的 新 会 话 : 


from sqlalchemy import create engine 
from sqlalchemy.orm import sessionmaker @ 





engine - create engine('sqlite:///:memory:') 
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Session = sessionmaker(bind=engine) € 


session = Session() © 


@ 导入 sessionmaker 类 。 
O 使 用 sessionmaker 提供 的 bind 配置 定义 Session 类 。 
© 使 用 生成 的 Session 类 创建 session， 供 我 们 使 用 。 


现在 已 经 有 了 一 个 可 用 来 与 数据 库 交 互 的 sesston。 虽 然 session 拥有 连接 数据 库 所 需 的 一 
切 ， 但 在 要 求 它 之 前 ， 它 是 不 会 自行 连接 到 数据 库 的 。 本 章 会 继续 拿 第 6 章 中 创建 的 类 作 
为 示例 。 这 里 ， 我 们 还 会 向 类 中 添加 一 些 repr 方法 ， 以 方便 查看 和 重建 对 象 实例 。 不 
过 ， 这 些 方法 并 不 是 必需 的 : 























from datetime import datetime 


from sqlalchemy import (Table, Column, Integer, Numeric, String, DateTime, 
ForeignKey) 

from sqlalchemy.ext.declarative import declarative base 

from sqlalchemy.orm import relationship, backref 


Base - declarative base() 


class Cookie(Base): 
. tablename _ = 'cookies' 


cookie id = Column(Integer(), primary key-True) 
cookie name - Column(String(50), index-True) 
cookie recipe url = Column(String(255)) 

cookie sku = Column(String(55)) 

quantity = Column(Integer()) 

unit cost = Column(Numeric(12, 2)) 


def repr (self): © 
return "Cookie(cookie_name='{self.cookie_name}', " \ 
"cookie recipe url-'([self.cookie recipe url]', " \ 
"cookie sku-'[self.cookie skuj', " X 
"quantity={self.quantity}, " V 
"unit cost-(self.unit cost])".format(self-self) 


class User(Base): 
. tablename  - 'users' 


user id - Column(Integer(), primary key-True) 

username - Column(String(15), nullable-False, unique-True) 
email address - Column(String(255), nullable-False) 

phone = Column(String(20), nullable-False) 

password = Column(String(25), nullable-False) 

created on = Column(DateTime(), default-datetime.now) 
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updated on = Column(DateTime(), default=datetime.now, 
onupdate-datetime.now) 
def repr (self): 
return "User(username='{self.username}', " X 
"email address-'(self.email address)', " X 
"phone='{self.phone}', " X 
"password='{self.password}')".format(self=self) 


class Order(Base): 
__tablename__ = 'orders' 
order_id = Column(Integer(), primary_key=True) 
user id = Column(Integer(), ForeignKey('users.user id')) 


user = relationship("User", backref=backref('orders', order byzorder id)) 


def _ repr (self): 
return "Order(user id-(self.user id), " V 
"shipped={self.shipped})".format(self=self) 


class LineItems(Base): 
__tablename__ = 'line items' 
line item id = Column(Integer(), primary_key=True) 
order id = Column(Integer(), ForeignKey('orders.order id')) 
cookie id = Column(Integer(), ForeignKey('cookies.cookie id')) 
quantity - Column(Integer()) 
extended cost - Column(Numeric(12, 2)) 
order = relationship("Order", backref-backref('line items', 
order by-line item id)) 
cookie = relationship("Cookie", uselist-False, order by-id) 


def repr (self): 
return "LineItems(order id-[self.order id), " V 
"cookie id-[self.cookie id), " V 
"quantity={self.quantity}, " V 
"extended cost-(self.extended cost])".format( 
self=self) 


Base.metadata.create_all(engine) @ 








O repr 方法 定义 了 应 该 如 何 表 示 对 象 。 当 调用 构造 函数 创建 并 打印 实例 时 ， 这 个 方 
法 会 被 调用 。 它 返回 的 内 容 将 在 稍 后 的 打印 输出 中 显示 。 
e 创建 引擎 定义 的 数据 库 表 。 


重新 创建 好 类 之 后 ， 该 学 习 如 何 处 理 数据 库 中 的 数据 了 。 让 我 们 从 插入 数据 开始 学 起 吧 。 


7.2 插入 数据 


为 了 在 数据 库 中 创建 一 条 新 的 cookie 记录 ， 先 初始 化 Cookie 类 的 一 个 新 实例 ， 这 个 实例 
中 包含 所 需 的 数据 。 然后， 把 Cookie 对 象 的 新 实例 添加 到 会 话 中 并 提交 会 话 。 这 很 容易 ， 





























因为 可 以 使 用 从 declarative base 继承 来 的 默认 构造 函数 ( 见 示 例 7-1). 
示例 7-1 插入 单个 对 象 


Cc cookie = Cookie(cookie_name='chocolate chip', © 
cookie recipe url-'http://some.aweso.me/cookie/recipe.html', 
Cookie sku-'CCO1', 
quantity-12, 
unit cost-0.50) 
session.add(cc cookie) @ 
session.commit() © 





@ 创建 Cookie 类 的 一 个 实例 。 
@ 将 实例 添加 到 会 话 。 


e 提交 会 话 。 


= 


当 调 用 会 话 的 commit() WERT, cookie 就 会 被 插入 到 数据 库 中 。 它 还 会 使 用 数据 库 中 记录 
的 主键 更 新 cc_cookie。 可 以 使 用 如 下 代码 进行 查看 : 











print(cc cookie.cookie id) 


1 
让 我 们 花 点 时 间 了 解 一 下 ， 当 运行 示例 7-1 中 的 代码 时 ， 数 据 库 都 发 生 了 什么 变化 。 当 我 


们 创建 Cookie 类 的 实例 并 将 其 添加 到 会 话 中 时 ， 甚 实 不 会 向 数据 库 发 送 任何 内 容 。 直 到 调 
会 话 的 commit() 方法 ， 才 会 把 内 容 发 送 到 数据 库 。 当 调用 commit() 时 ， 会 发 生 以 下 事情 : 




















INFO:sqlalchemy.engine.base.Engine:BEGIN (implicit) © 


INFO:sqlalchemy.engine.base.Engine:INSERT INTO cookies (cookie name, 
cookie recipe url, cookie sku, quantity, unit cost) VALUES (?, ?, ?, ?, ?) O 


INFO:sqlalchemy.engine.base.Engine:('chocolate chip', 
'http://some.aweso.me/cookie/recipe.html', 'CCO1', 12, 0.5) © 


INFO:sqlalchemy.engine.base.Engine:COMMIT @ 
0 启动 事务 。 
@ 把 记录 插入 到 数据 库 。 
© 插入 的 值 。 
@ 提交 事务 。 








如 果 想 了 解 具 体 细节 ， 可 以 把 echo=True TEASE SBE INE create_engine 
ee 但 是 注意 要 把 它 放 到 连接 字符 串 的 后 面 。 这 个 参数 只 在 测试 中 使 
用 ， 在 实际 软件 产品 中 ， 请 一 定 不 要 添加 这 个 参数 。 
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首先 ， 局 动 一 个 新 事务 ， 把 记录 插入 数据 库 。 然 后 ， 引 警 发 送 insert 语句 的 值 。 最 后 ， 提 
交 事 务 到 数据 库 ， 并 关闭 事务 。 这 种 处 理 方法 通常 被 称 为 “工作 单元 ”模式 。 


接 下 来 看 看 几 种 插入 多 条 记录 的 方法 。 如 果 打 算 插 入 对 象 之 后 再 对 它们 做 一 些 其 他 的 处 
里 ， 那 么 需要 使 用 示例 7-2 中 提 到 的 方法 。 这 里 只 是 简单 地 创建 两 个 实例 ， 而 后 把 它们 添 
加 到 会 话 中 ， 然 后 再 提交 会 话 。 


示例 7-2 插入 多 条 记录 

dcc = Cookie(cookie_name='dark chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe dark.html', 
cookie sku-'CC02', 
quantity-1, 
unit cost-0.75) 

mol = Cookie(cookie_name='molasses', 
cookie_recipe_url='http://some.aweso.me/cookie/recipe_molasses.html', 
cookie skuz'MOLO01', 
quantity-1, 
unit cost-0.80) 

session.add(dcc) @ 

session.add(mol) O 

session.flush() © 

print(dcc.cookie id) 

print(mol.cookie id) 















































xd 














© 添加 dark chocolate chip cookie, 
@ 添加 molasses cookie, 


e 刷新 会 话 。 





请 注意 ， 在 示例 7-2 中 ， 我 们 使 用 了 会 话 的 flushO 方法 而 不 是 commit() 方法 。fLush() 
方法 和 commit() 方法 相似 ， 但 是 它 不 会 执行 数据 库 提交 并 结束 事务 。 因 此 ，dcc 和 mol 实 
例 仍 然 和 会 话 连接 ， 你 可 以 使 用 它们 执行 更 多 数据 库 任 务 ， 而 无 须 另 外 发 起 数据 库 查 询 。 
虽然 我 们 要 向 数据 库 中 添加 多 个 记录 ， 但 只 调用 sesston.flushO 语句 一 次 就 够 了 。 调 用 
flush) 方法 会 把 两 条 插入 语句 放 人 一 个 事务 中 ， 并 发 送 到 数据 库 。 执 行 示例 7-2 中 的 代 
码 ， 会 得 到 如 下 结果 : 
































2 
3 


当 你 想 往 数据 表 中 插入 数据 ， 并 且 不 需要 对 数据 做 额外 处 理 时 ， 使 用 flush) 方法 会 更 好 ， 
它 允 许 你 一 次 性 向 数据 库 插入 多 条 记录 。 和 示例 7-2 中 使 用 的 方法 不 同 ， 示例 7-3 中 的 方 
法 不 会 把 记录 与 会 话 关联 起 来 。 


示例 7-3 ”批量 插入 多 条 记录 
c1 = Cookie(cookie_name='peanut butter', 
cookie recipe url-'http://some.aweso.me/cookie/peanut.html', 
cookie skuz'PB01', 








quantity-24, 
unit cost-0.25) 
C2 = Cookie(cookie_name='oatmeal raisin', 
cookie recipe url-'http://some.okay.me/cookie/raisin.html', 
cookie sku-'EWWO01', 
quantity-100, 
unit cost-1.00) 
session.bulk save objects([c1,c2]) © 
session.commit() 
Print(ci.cookie id) 


O 添加 cookie 至 列表 ， 并 使 用 bulk_save_objects 方法 批量 保存 。 


执行 示例 7-3 不 会 将 任何 内 容 打 印 到 屏幕 上 ， 因 为 cl 对 象 与 会 话 没 有 关联 ， 并 且 无 法 刷新 
cookie id 进行 打印 。 如 果 查 看 发 送 到 数据 库 的 内 容 ， 可 以 看 到 事务 中 只 有 一 条 插入 语句 : 






































INFO:sqlalchemy.engine.base.Engine:INSERT INTO cookies (cookie name, 
cookie recipe url, cookie sku, quantity, unit cost) VALUES (?, ?, ?, ?, ?) O 


INFO: sqlalchemy.engine.base.Engine:( 

('peanut butter', 'http://some.aweso.me/cookie/peanut.html', 'PBO1', 24, 0.25), 
('oatmeal raisin', 'http://some.okay.me/cookie/raisin.html', 'EWWO1', 100, 1.0)) 
INFO:sqlalchemy.engine.base.Engine:COMMIT 


o 单个 插入 。 

相 比 于 示例 7-2 中 使 用 多 条 add 语句 和 插入 语句 的 做 法 ， 示 例 7-3 中 的 方法 执行 起 来 要 快 得 多 。 
但 是 ， 这 种 速度 的 提升 是 以 牺牲 在 正常 添加 和 提交 中 可 使 用 的 一 些 特性 为 代价 的 ， 例 如 ; 
。 关系 设置 和 操作 得 不 到 遵守 或 触发 ; 

。 对 象 没有 连接 到 会 话 ; 

。 默认 情况 下 ， 不 获取 主键 ， 

。 不 会 触发 任何 事件 。 

除了 bulk save objects 方法 之 外 ， 还 有 其 他 多 种 通过 字典 创建 和 更 新 对 象 的 方法 ， 你 可 
以 在 SQLAlchemy 文档 中 了 解 更 多 有 关 批 量 操作 及 其 性 能 的 内 容 。 


如 果 你 想 插入 多 条 记录 ， 并 且 不 需要 访问 关系 或 插入 的 主键 ， 请 使 用 butk_ 
save objects 或 相关 方法 。 尤 其 是 从 外 部 数据 源 (例如 CSV sii f e E 
组 的 大 型 ISON 文档 ) 获取 数据 时 ， 强 烈 建 议 你 这 样 做 。 


HÆ, cookies 表 中 已 经 有 了 一 些 数据 。 接 下 来 学 习 如 何 查 询 表 以 及 获取 这 些 数 据 。 
7.3 查询 数据 


构建 查询 时 要 用 到 会 话 实例 的 query() 方法 。 首 先 ， 把 Cookie 类 传递 给 query() 方法 ， 这 
样 就 能 获取 cookies 表 中 的 所 有 记录 ， 如 示例 7-4 所 示 。 
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示例 7-4 获取 所 有 cookie 


cookies = session.query(Cookie).all() © 
print(cookies) 


@ 返回 一 个 Cookie 实例 列表 ， 代 表 cookies 表 中 的 所 有 记录 。 
示例 7-4 的 输出 结果 如 下 : 





[ 
Cookie(cookie_name='chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe.html', 
cookie sku-'CC01', quantity-12, unit cost-0.50), 
Cookie(cookie name-'dark chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe dark.html', 
cookie skuz'CC02', quantity-1, unit cost-0.75), 
Cookie(cookie_name='molasses', 
cookie_recipe_url='http://some.aweso.me/cookie/recipe_molasses.html', 
cookie sku-'MOL01', quantity-1, unit cost-0.80), 
Cookie(cookie_name='peanut butter', 
cookie recipe url-'http://some.aweso.me/cookie/peanut.html', 
cookie sku-'PB01', quantity-24, unit cost-0.25), 
Cookie(cookie_name='oatmeal raisin', 
cookie recipe url-'http://some.okay.me/cookie/raisin.html', 
cookie skuz'EWW01', quantity-100, unit cost-1.00) 
] 


IN 





因为 返回 值 是 一 个 对 象 列表 ， 所 以 我 们 可 以 像 往 常 一 样 使 用 这 些 对 象 。 由 于 这 些 对 象 与 
会 话 相 连 ， 所 以 我 们 可 以 更 改 或 删除 它们 ， 并 将 更 改 持久 化 到 数据 库 中 。 相 关内 容 后 面 
会 讲解 。 
除了 一 次 性 获取 所 有 对 象 之 外 ， 还 可 以 将 查询 用 作 可 迭代 对 象 来 遍历 查询 结果 ， 如 示例 
7-5 所 示 。 


示例 7-5 ”将 查询 用 作 可 返 代 对 象 
for cookie in session.query(Cookie): Q9 
print(cookie) 




















@ AFA PE IA TSR VA all). 





使 用 和 迭代 方法 的 过 程 中 ， 可 以 分 别 和 每 个 记录 对 象 交 互 ， 释 放 某 个 对 象 ， 并 获得 下 一 个 对 象 。 


运行 示例 7-5， 会 得 到 如 下 结果 : 





Cookie(cookie_name='chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe.html', 
cookie sku-'CC01', quantity-12, unit cost-0.50), 

Cookie(cookie name-'dark chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe dark.html', 
cookie sku-z'CC02', quantity-1, unit cost-0.75), 





Cookie(cookie_name='molasses', 
cookie_recipe_url='http://some.aweso.me/cookie/recipe_molasses.html', 
cookie sku-'MOLO1', quantity=1, unit_cost=0.80), 

Cookie(cookie_name='peanut butter', 
cookie_recipe_url='http://some.aweso.me/cookie/peanut.html', 
cookie sku-z'PB01', quantity=24, unit_cost=0.25), 

Cookie(cookie_name='oatmeal raisin', 
cookie_recipe_url='http://some.okay.me/cookie/raisin.html', 
cookie_sku='EWW01', quantity-100, unit cost-1.00) 











除了 将 查询 用 于 迭代 和 调用 其 alLtL() 方法 外 ， 还 有 许多 其 他 访问 数据 的 方法 。 可 以 使 用 以 
下 方法 获取 结果 。 








first() 
若 有 ， 则 返回 第 一 个 记录 对 象 。 





one() 


查询 所 有 行 ， 如 果 返 回 的 不 是 单个 结果 ， 则 抛 出 异常 。 





























scalar() 


返回 第 一 个 结果 的 第 一 个 元 素 。 若 无 结果 ， 返 回 None;， 若 结果 多 于 一 个 ， 则 引发 错误 。 



































最 佳 实 践 

编写 生产 代码 时 ， 应 该 遵循 如 下 指导 方针 。 

。 使 用 选 代 而 非 aLL() 方法 获取 记录 。 它 比 处 理 完 整 的 对 象 列 表 更 节省 内 存 ， 而 且 我 
们 往往 一 次 只 处 理 一 条 记录 。 

。 要 获取 单条 记录 ， 请 使 用 first() 方法 ， 而 非 one() 或 scalar() 方 法， 因为 其 他 
程序 员 同 事 更 容易 理解 它 。 但 是 ， 如 果 你 确定 查询 中 有 且 只 有 一 个 结果 ， 那 请 使 用 
one() 方法 。 

。 请 谨慎 使 用 scalar() 方法 ， 因 为 如 果 查 询 返回 的 数据 不 只 一 行 一 列 ， 它 就 会 引发 
错误 。 当 查询 获取 的 是 全 部 记录 时 ， 该 方法 会 返回 整个 记录 对 象 ， 这 会 造成 混 清 并 
导致 错误 。 














每 次 执行 前 面 的 示例 代码 查询 数据 库 时 ， 返 回 的 每 条 记录 都 包含 所 有 列 。 我 们 在 工作 中 通 
常 只 需要 用 到 这 些 列 的 一 部 分 。 如 果 这 些 额 外 列 中 的 数据 很 大 ， 应 用 程序 的 速度 就 会 被 拖 
慢 ， 而 且 消 耗 的 内 存 远 远 超过 预期 。 尽 管 SQLAlchemy 不 会 为 查询 或 对 象 添加 大 量 开销 ， 
但 是 ， 如 果 查 询 占用 了 太 多 内 存 ， 首 先 要 考虑 查询 返回 的 数据 是 否 有 问题 。 接 下 来 看 看 如 
何 对 查询 返回 的 列 数 进行 了 限制 。 
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7.9.4 控制 查询 中 的 列 数 
为 了 限制 查询 返回 的 列 数 ， 需 要 把 要 查询 的 列传 递 给 queryO 方法 ， 各 个 列 之 间 用 逗号 分 
隔 。 例 如 ， 你 想 运 行 一 个 查询 ， 这 个 查询 只 返回 cookie 的 名 称 和 数量 ， 如 示例 7-6 所 示 。 





示例 7-6 只 查询 cookie_name 和 quantity 两 列 


print(session.query(Cookie.cookie name, Cookie.quantity).first()) © 





© 从 cookies 表 查 询 cookie name 和 quantity 两 个 列 ， 并 返回 第 一 个 结果 。 





运行 示例 7-6， 会 得 到 如 下 结果 : 


(u'chocolate chip', 12) 








从 上 面 的 结果 可 以 看 到 ， 查 询 返回 的 是 一 个 由 指定 列 的 列 值 组 成 的 元 组 。 


我 们 已 经 可 以 构建 简单 的 查询 语句 了 ， 接 下 来 看 看 还 可 以 做 些 什么 来 改变 查询 语句 返回 结 
果 的 方式 。 首 先 学 习 如 何 改变 返回 结果 的 顺序 。 
































7.3.2 BER 

查看 示例 7-6 的 所 有 结果 ， 而 不 仅仅 是 第 一 条 记录 ， 你 会 发 现 数据 并 不 是 按照 特定 顺序 排 
列 的 。 如 果 和 希望 返回 的 列表 有 特定 的 顺序 ， 可 以 使 用 order byO 语句 ， 如 示例 7-7 所 示 。 
示例 中 ， 我 们 希望 结果 按照 现 有 cookie 的 数量 进行 排序 。 


示例 7-7 按 数 量 进行 升序 排列 


for cookie in session.query(Cookie).order by(Cookie.quantity): 
print('[:3) - {}'.format(cookie.quantity, cookie.cookie name)) 








运行 示例 7-7， 会 得 到 如 下 结果 : 


1 - dark chocolate chip 
1 - molasses 

12 - chocolate chip 

24 - peanut butter 

100 - oatmeal raisin 


如 果 想 按 倒序 或 降序 排列 ， 请 使 用 desc() 语句 。 这 个 国 数 的 作用 是 按 降序 方式 包装 要 排序 
的 特定 列 ， 如 示例 7-8 所 示 。 


示例 7-8 按照 数量 进行 降序 排列 
from sqlalchemy import desc 
for cookie in session.query(Cookie).order by(desc(Cookie.quantity)): © 
print('[:3) - {}'.format(cookie.quantity, cookie.cookie name)) 


@ 我 们 把 想 要 按照 倒序 排列 的 列 放 入 descO 函数 中 。 





desc() 国 数 还 可 以 作为 列 对 象 (比如 cookte.c.quantity.desc()) 的 方法 进 
行 调用 。 但 是 ， 如 果 在 长 语句 中 这 样 使 用 ， 可 能 会 造成 阅读 困难 ， 所 以 我 总 
是 把 desc() HERZ. 





























如 果 应 用 程序 只 需要 返回 结果 的 一 部 分 ， 可 以 对 返回 的 结果 数量 进行 限制 。 下 面 来 具体 
HH, 





7.3.3 限制 返回 结果 集 的 条 数 

在 前 面 的 示例 中 ， 我 们 使 用 first() 方法 仅 获取 一 行 记录 。 虽 然 query() 提供 了 我 们 请 求 
的 那 行 ， 但 查询 实际 运行 时 会 访问 所 有 结果 ， 而 不 仅仅 是 单个 记录 。 如 果 想 对 查询 进行 限 
制 ， 可 以 使 用 切片 符号 (slice notation) 让 limit 语句 成 为 查询 的 一 部 分 。 比 如 ， 你 的 时 间 
只 够 制作 两 批 cookie， 你 想 知道 应 该 制作 哪 两 种 cookie， 那 么 你 可 以 使 用 前 面 带 顺序 的 查 
询 ， 并 添加 Limit 语句 来 返回 最 需要 补充 的 那 两 种 cookie。 示 例 7-9 显示 了 具体 做 法 。 


示例 7-9 两 种 库存 量 最 少 的 cookie 
query = session.query(Cookie).order by(Cookie.quantity)[:2] 
print([result.cookie name for result in query]) @ 











@ 运行 查询 并 将 返回 的 列表 切片 。 对 大 型 结果 集 来 说 ， 这 种 做 法 的 效率 可 能 会 很 低 。 

















运行 示例 7-9， 会 得 到 如 下 结果 : 
[u'dark chocolate chip', u'molasses'] 

除了 使 用 切片 符号 外 ， 还 可 以 使 用 Limit() 语句 。 

示例 7-10 ”两 种 库存 量 最 少 的 cookie. (使 用 Limit()) 


query = session.query(Cookie).order by(Cookie.quantity).limit(2) 
print([result.cookie name for result in query]) 


现在 ， 你 已 经 知道 需要 烤 哪 两 种 cookie 了 ， 你 可 能 还 想 知 道 当 前 库存 中 还 有 多 少 cookie, 
许多 数据 库 都 包含 SQL 函数 ， 这 些 函 数 的 设计 目的 是 让 某 些 操作 可 以 直接 在 数据 库 服务 器 
上 使 用 ， 比 如 SUM。 接 下 来 学 习 一 下 如 何 使 用 这 些 函 数 。 








7.3.4 ”内 置 SQL 函 数 和 标签 

SQLAIchemy 还 可 以 使 用 后 端 数 据 库 中 的 SQL 函数 。 其 中 ， 两 个 很 常用 的 数据 库 函 数 是 
SUM() 和 COUNT()。 要 使 用 这 两 个 函数 ， 需 要 先导 入 sqlalchemy.func 模块 。 这 两 个 函数 被 
包装 在 它们 操作 的 列 上 。 因 此 ， 要 获得 cookie 的 总 数 ， 可 以 使 用 示例 7-11 中 的 代码 。 
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示例 7-11 统计 cookie 数量 
from sqLaLchemy import func 


inv count = session.query(func.sum(Cookie.quantity)).scalar() © 
print(inv count) 


o 请 注意 ， 这 里 使 用 了 scatar()， 它 只 返回 第 一 个 记录 最 左边 的 列 。 





我 一 般 总 会 导入 func 整个 模块 ， 因 为 直接 导入 sum 可 能 会 引起 问题 ， 而 且 还 
容易 和 Python 内 置 的 sum 函数 混淆 。 








运行 示例 7-11 ， 会 得 到 如 下 结果 : 
138 

接 下 来 ， 使 用 count 函数 查看 一 下 cookies 表 中 有 几 种 cookie ( 见 示例 7-12) 

示例 7-12 ”统计 库存 中 有 几 种 cookie 


rec count = session.query(func.count(Cookie.cookie name)).first() 
print(rec count) 


在 示例 7-11 中 ， 我 们 使 用 scalar() 方法 得 到 了 单个 值 。 与 此 不 同 ， 在 示例 7-12 F, Ri 
得 到 的 是 一 个 元 组 ， 因 为 我 们 使 用 first() 方法 换 掉 了 scalar) 方法 。 





(5,) 


使 用 count() 和 sum() 这 类 函数 最 终 会 返回 元 组 或 列 名 为 count_1 的 结果 。 这 些 返回 形式 
通常 不 是 我 们 想 要 的 。 男 外 ， 如 果 查 询 中 有 多 个 统计 ， 那 我 们 必须 知道 它们 在 语句 中 的 出 
现 次 数 ， 并 将 其 合并 到 列 名 ， 因 此 第 四 个 count() 函数 将 是 count_4。 命 名 应 该 清晰 、 明 
确 ， 特 别 是 当 周 围 有 其 他 Python 代码 时 。 



































不 过 ， 值 得 庆幸 的 是 ，SQLAlchemy 提供 了 label() 这 个 函数 来 解决 这 个 问题 。 示 例 7-13 
执行 的 查询 与 示例 7-12 一 样 ， 但 是 它 通过 调用 label() 函数 为 我 们 访问 的 列 起 了 一 个 更 有 
用 的 名 字 。 


示例 7-18 ” 重 命 名 统计 列 


rec count = session.query(func.count(Cookie.cookie name) V 
.label('inventory count')).first() © 

print(rec count.keys()) 

print(rec count.inventory count) 





o 在 想 更 改 的 列 对 象 上 调用 label() 函数 。 


运行 示例 7-13， 会 得 到 如 下 结果 : 
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[u'inventory count'] 
5 








我 们 已 经 学 习 了 如 何 限制 从 数据 库 返 回 的 列 或 行 的 数量 。 接 下 来 学 习 如 何 根据 指定 的 条 件 
AY AEH ETT LUE 





7.3.5 ”过滤 

过 滤 查 询 是 通过 在 查询 后 面 添 加 filter() 语句 完成 的 。 典 型 的 filter O 子 句 包含 一 个 列 、 
一 个 运算 符 和 一 个 值 或 列 。 可 以 把 多 个 filter) 子 句 接 在 一 起 使 用 ， 或 者 在 单个 filter() 
中 添加 多 个 采用 逐 号 分 隔 的 ClauseElement 表达 式 ， 它 们 的 作用 就 像 传统 SQL 语句 中 的 
AND 一 样 。 在 示例 7-14 中 ， 我 们 将 查找 名 为 “chocolate chip” 的 cookie。 


示例 7-14 使 用 filter() 过 滤 cookie 名 


record = session.query(Cookie).filter(Cookie.cookie name == 'chocolate chip').first() 
print(record) 





运行 示例 7-14， 将 打印 出 chocolate chip cookie 的 记录 : 


Cookie(cookie_name='chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe.html', 
Cookie sku-z'CC0O1', quantity-12, unit cost-0.50) 





除 此 之 外 ， 还 有 一 个 filter_by() 方法 ， 其 工作 方式 和 filter() 方法 类 似 ， 只 是 它 没有 明 
确 要 求 把 类 作为 过 滤器 表达 式 的 一 部 分 ， 而 是 使 用 属性 关键 字 表达 式 ， 这 些 表达 式 来 自 于 
查询 的 主 实体 或 最 后 一 个 连接 到 语句 的 实体 。 另 外 ，filter_by() 使 用 的 是 关键 字 赋 值 而 
非 布尔 值 。 示 例 7-15 执行 的 查询 和 示例 7-14 完全 一 样 。 








示例 7-15 使 用 filter_by() 过 滤 cookie name 


record = session.query(Cookie).filter by(cookie name-'chocolate chip').first() 
print(record) 


还 可 以 使 用 where 语句 来 查找 所 有 包含 “chocolate” 这 个 词 的 cookie 4 ( 见 示例 7-16) 。 


示例 7-16 ”查找 名 字 中 包含 “chocolate” 的 cookie 


query = session.query(Cookie).filter(Cookie.cookie name.like('%chocolate%')) 
for record in query: 
print(record.cookie name) 


运行 示例 7-16， 会 得 到 如 下 结果 : 


chocolate chip 
dark chocolate chip 


在 示例 7-16 中 ， 我 们 在 过 滤器 语句 中 把 Cookie.cookie_name 列 作 为 一 种 ClauseElement 来 
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过 滤 结 果 ， 并 且 调 用 了 ClauseElement 的 like() 方法 做 匹配 。 此 外 ， 还 有 很 多 其 他 方法 可 
供 选 择 ， 请 参考 表 2-1, 


如 果 不 使 用 任何 一 个 ClauseElement 方法 ， 那 么 就 要 在 过 滤器 子 句 中 使 用 运算 符 。 大 多 数 
运算 符 的 工作 方式 和 你 预想 的 一 样 。 接 下 来 讲 讲 这 些 运算 符 之 间 存 在 的 一 些 差异 。 


7.3.6 ”运算 符 


BJA RAIL, 我 们 用 来 过 滤 数 据 的 方法 有 两 种 : 一 是 利用 列 是 否 等 于 某 个 值 ， 二 是 使 
用 ClauseElement 的 方法 ， 比 如 tike()。 此 外 ， 还 可 以 使 用 许多 常见 的 运算 符 来 过 滤 数 
据 。SQLAlchemy 对 大 多 数 标准 Python 操作 符 做 了 重 载 ， 包 括 所 有 标准 的 比较 运算 符 
(==、!=、<、>、<=、>=)， 它 们 的 功能 和 在 Python 语句 中 完全 一 样 。 在 与 None 比较 时 ，== 
运算 符 被 重 载 为 ITS NULL 语句 。 算 术 运 算 符 (\+、-、*、/ 和 %) 还 可 以 用 来 对 独立 于 数据 
库 的 字符 串 做 连接 处 理 ， 如 示例 7-17 所 示 。 


示例 7-17 使 用 + 连接 字符 串 
results = session.query(Cookie.cookie name, 'SKU-' + Cookie.cookie sku).all() 
for row in results: 
print(row) 














示例 7-17 的 运行 结果 如 下 : 


('chocolate chip', 'SKU-CCO1') 
('dark chocolate chip', 'SKU-CC02') 
('molasses', 'SKU-MOLO1') 

('peanut butter', 'SKU-PB01') 
('oatmeal raisin', 'SKU-EWWO01') 


运算 符 的 另 一 个 常见 用 法 是 根据 多 个 列 来 计算 值 。 在 处 理财 务 数据 或 统计 数据 的 应 用 程序 
和 报表 中 ， 你 经 常 要 这 样 做 。 示 例 7-18 是 计算 库存 价值 的 一 个 例子 。 


示例 7-18 计算 各 种 cookie 的 库存 价值 
from sqlalchemy import cast @ 
query = session.query(Cookie.cookie name, 
cast((Cookie.quantity * Cookie.unit cost), 
Numeric(12,2)).label('inv cost')) O 





























for result in query: 
print('{} - (J'.format(result.cookie name, result.inv cost)) 

















@ castO 函数 允许 我 们 做 类 型 转换 。 本 例 中 ， SAL TERCER ELT. 60000000000 3 
个 样子 ， 通 过 强制 类 型 转换 ， 我 们 可 以 让 它 看 起 来 像 货 币 。 在 Python 中 ， 还 可 以 使 用 
print('() - {:.2f}'.format(row.cookie_name, row.inv_cost)) 完成 相同 的 任务 。 

@ 这 里 再 次 使 用 labelO) 函数 对 列 进行 重 命 名 。 如 果 不 进 行 重 命名 ， 列 就 不 会 出 现在 
result 对 象 的 keys H, ae det 














示例 7-18 生成 的 结果 如 下 : 


chocolate chip - 6.00 
dark chocolate chip - 0.75 
molasses - 0.80 

peanut butter - 6.00 
oatmeal raisin - 100.00 




















如 有 果 需 要 组 合 where 语句 ， 有 两 种 方法 可 供 我 们 选用 ， 其 中 一 种 方法 就 是 布尔 运算 符 。 


7.3.7 布尔 运算 符 

SQLAlchemy 还 支持 SQL 布尔 运算 符 AND、OR 和 NOT， 它 们 用 位 运算 符 (&8、| 和 ~) 
来 表示 。 受 Python 运算 符 优先 级 规则 的 影响 ， 在 使 用 AND 或 OR 重 载运 算 符 时 一 定 要 特别 小 
心 。 比 如 ，& Eb < 优先 级 高 ， 所 以 当 你 写 A < B & C < D 时， 你 想得到 的 是 (A < B) &(C < D), 
而 实际 得 到 的 却 是 A < (B&C) < D, 














我 们 经 常 希望 用 包含 和 排除 的 方式 把 多 个 where 子 句 链接 在 一 起 ， 这 可 以 通过 使 用 连接 词 





7.3.8 连接 词 


为 了 获得 所 期 望 的 效果 ， 我 们 既 可 以 把 多 个 filter() 子 句 链接 在 一 起 ， 也 可 以 使 用 连接 词 
来 实现 ， 而 且 使 用 连接 词 的 可 读 性 更 好 、 功 能 性 更 强 。 我 还 喜欢 使 用 连接 词 代 替 布 尔 运算 
符 ， 因 为 连接 词 会 让 代码 更 具 表现 力 。SQLAlchemy 的 连接 词 有 and_()、or_() 和 not_()。 
这 些 连 接 词 带 有 下 划 线 ， 以 便 与 内 置 的 关键 字 区 分 开 。 如 果 想 获取 价格 低 于 某 个 数 且 数量 
超过 指定 值 的 cookie 列表 ， 可 以 使 用 示例 7-19 中 的 代码 。 


示例 7-19 ”使 用 带 有 多 个 ClauseElement 表达 式 的 filter() 做 AND 运算 


query = session.query(Cookie).filter( 
Cookie.quantity » 23, 
Cookie.unit cost « 0.40 

) 

for result in query: 
print(result.cookie name) 












































or. O 函数 的 作用 与 and_() 函数 正好 相反 ， 只 要 记录 满足 其 中 一 个 条 件 ， 就 会 被 选 出 来 。 
如 果 想 搜索 库存 中 数量 在 10 到 50 之 间或 名 字 中 包含 chip 这 个 词 的 cookie， 可 以 使 用 示例 
7-20 中 的 代码 。 








示例 7-20 使 用 or() 连接 词 
from sqlalchemy import and , or , not. 
query = session.query(Cookie).filter( 
or_( 
Cookie. quantity.between(10, 50), 
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Cookie.cookie name.contains('chip') 
J 
) 


for result in query: 
print(result.cookie_name) 





运行 示例 7-20， 会 得 到 如 下 结果 : 


chocolate chip 
dark chocolate chip 
peanut butter 





not_() 函数 的 工作 方式 与 其 他 连接 词类 似 ， 用 来 选择 那些 与 指定 条 件 不 匹配 的 记录 。 





现在 我 们 已 经 可 以 轻松 地 查询 数据 了 ， 接 下 来 该 学 习 如 何 更 新 现 有 数据 了 。 


7.4 更 新 数据 


update() 方法 和 前 面 用 过 的 insert() 方法 很 相似 ， 它 们 的 语法 几乎 完全 一 样 ， 但 是 
update() 可 以 指定 一 个 where 子 句 ， 用 来 指出 要 更 新 哪些 行 。 与 插入 语 名 一样， 更 新 语句 
可 以 由 update() 函数 或 者 表格 的 update() 方法 来 创建 。 如 果 省 略 where 子 句 ， 则 表示 要 
更 新 表 中 的 所 有 行 。 


例如 ， 假 设 你 已 经 完成 了 库存 所 需 巧克力 饼干 (chocolate chip cookies) 的 烘焙 工作 。 在 示 
例 7-21 中 ， 我 们 先 通过 更 新 查询 把 烘焙 好 的 巧克力 饼干 添加 到 当前 库存 中 ， 再 查看 当前 库 
存 中 巧克力 饼干 的 数量 。 


示例 7-21 通过 对 象 更 新 数据 
query = session.query(Cookie) @ 
cc cookie = query.filter(Cookie.cookie name == "chocolate chip").first() O 
cc cookie.quantity = cc cookie.quantity + 120 
session.commit() 
print(cc cookie.quantity) 












































o 第 1 行 和 第 2 行使 用 生成 方法 构建 语句 。 
@ 这 里 ， 我 们 要 获取 对 象 。 但 是 ， 如 果 你 已 经 有 对 象 了 ， 可 以 直接 编辑 它 ， 而 不 必 再 次 
查询 了 。 


运行 示例 7-21， 会 得 到 如 下 结果 : 








132 


此 外 ， 也 可 以 就 地 更 新 数据 ， 而 无 须 先 获取 对 象 ( 见 示例 7-22)。 





示例 7-22 ”就 地 更 新 数据 
query = session.query(Cookie) 
query = query.filter(Cookie.cookie name == "chocolate chip") 
query.update({Cookie.quantity: Cookie.quantity - 20}) © 





cc_cookie = query.first() @ 
print(cc_cookie. quantity) 











O update() 方法 在 会 话 外 部 更 新 记录 ， 并 返回 更 新 的 行 数 。 
o 这 里 重用 query 对 象 ， 因 为 它 有 我 们 需要 的 选择 条 人 


运行 示例 7-22， 会 得 到 如 下 结果 : 
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o 
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除了 更 新 数据 之 外 ， 某 些 时 候 ， 我 们 还 想 从 表 中 删除 某 些 数据 。 接 下 来 学 习 如 何 删除 数据 。 


7.5 删除 数据 


创建 删除 语句 时 ， 既 可 以 使 用 deleteO 函数 ， 也 可 以 使 用 表 (包含 待 删 数 据 的 表 ) B 
delete() 方法 。 与 insert() 和 update() 不 同 ，delete() 不 接收 值 参数 ， 只 接收 一 Ron 
where 子 句 ， 用 来 指定 删除 范围 (Aik where 子 句 表示 删除 表 中 的 所 有 行 )。 请 看 示例 7-23。 


示例 7-23 ”删除 数据 
query = session.query(Cookie) 
query = query.filter(Cookie.cookie name == "dark chocolate chip") 
dcc cookie = query.one() 
session.delete(dcc cookie) 
session.commit() 
dcc cookie = query.first() 
print(dcc cookie) 

















运行 示例 7-23， 会 得 到 如 下 结果 : 

None 

此 外 ， 也 可 以 就 地 删除 数据 ， 而 无 须 先 歼 取 待 删 对 象 〔 见 示例 7-24) 。 
示例 7-24 ”删除 数据 


query = session.query(Cookie) 
query = query.filter(Cookie.cookie name == "molasses") 
query.delete() 


mol cookie = query.first() 
print(mol cookie) 


运行 示例 7-24， 会 得 到 如 下 结果 : 
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None 





现在 ， 让 我 们 综合 运用 前 面 学 过 的 内 容 向 users、orders 和 line. items 表 中 加 载 一 些 数 








据 。 你 可 以 直接 复制 下 面 这 
的 方法 。 











cookiemon = User(username='cookiemon', 
email_address='mon@cookie.com', 
phone='111-111-1111', 
password='password' ) 

cakeeater = User(username='cakeeater', 
email_address='cakeeater@cake.com', 
phonez'222-222-2222', 
password='password' ) 

pieperson = User(username='pieperson', 
email_address='person@pie.com', 
phone= ' 333-333-3333', 
password='password' ) 

session.add(cookiemon) 

session.add(cakeeater ) 

session.add(pieperson) 

session.commit() 


这 些 代码 进行 添加 ， 不 过 最 好 花 点 时 间 尝 试 使 用 不 同 的 插入 数据 





现在 ， 我 们 有 了 客户 ， 接 下 来 开始 把 他 们 的 订单 和 行 项 目 输入 到 系统 中 。 在 把 这 两 个 对 象 




















通过 把 iiid 对 关系 属性 来 实现 ， 就 像 我们 对 其 他 属性 所 做 的 那样 。 你 会 
次 看 到 这 一 点 。 


示例 7-25 ”添加 相关 对 象 
o1 = Order() 
o1.user = cookiemon © 
session.add(o1) 





cc = session.query(Cookie).filter(Cookie.cookie name == 
"chocolate chip") .one() 
linei = LineItem(cookie-cc, quantity=2, extended cost-1.00) @ 


pb = session.query(Cookie).filter(Cookie.cookie name == 
"peanut butter").one() 

line2 = LineItem(quantity-12, extended_cost=3.00) © 

line2.cookie = pb 

line2.order - o1 


o1.line items.append(line1) @ 
o1.line items.append(line2) 


session.commit() 


@ 把 cookiemon 设置 为 下 订单 的 用 户 。 
@ 为 订单 创建 一 个 行 项 目 ， 并 与 cookie 关联 。 








插入 到 表 中 时 ， 我 们 会 利用 它们 之 间 的 关系 。 如 果 想 将 一 个 对 象 关联 到 另 一 个 对 象 ， 可 以 


在 示例 7-25 中 多 








@ 一 次 构建 一 个 行 项 目 。 
O 通过 关系 把 行 项 目 添加 到 i] 单 中 。 





在 示例 7-25 中 ， 我 们 创建 了 一 个 空 的 order 实例 ， 并 将 其 user 属性 设置 为 cooktemon 实 
例 。 接 下 来 ， 将 它 添加 到 会 话 中 。 然 后 查询 chocolate chip cookie 并 创建 一 个 LineItem， 把 
cookie 设置 为 刚才 查询 的 chocolate chip cookie。 我 们 对 订单 的 第 二 行 项 目 重复 这 个 过 程 ， 
但 要 一 步 步 地 创建 。 最 后 ， 将 行 项 目 添加 到 订单 中 并 提交 订单 。 
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下 面 为 男 一 个 用 户 再 添加 一 个 订单 。 











02 = Order() 
02.user = cakeeater 


cc = session.query(Cookie).filter(Cookie.cookie name == 
"chocolate chip").one() 
linei = LineItem(cookie=cc, quantity=24, extended_cost=12.00) 


oat = session.query(Cookie).filter(Cookie.cookie_name == 
"oatmeal raisin").one() 
line2 = LineItem(cookie=oat, quantity=6, extended_cost=6.00) 


02.line items.append(line1) 
02.line items.append(line2) 


session.add(o2) @ 
session.commit() 





@ 我 将 这 一 行 与 其 他 添加 内 容 一 起 向 下 移动 ，SQLAlchemy 会 确定 创建 它们 的 适当 顺序 ， 
以 确保 成 功 。 

第 6 章 中 ， 我 们 学 习 了 如 何 定义 ForeignKeys 和 关系 ， 但 是 到 目前 为 止 ， 我 们 还 没有 用 它 

们 做 过 查询 。 下 面 就 来 看 看 这 些 关系 。 


7.6 连接 


下 面 学 习 如 何 使 用 3oinO 和 outerjoinO 方法 来 查询 相关 数据 。 例 如 ， 为 了 执行 cookiemon 
客户 所 下 的 订单 ， 我 们 需要 确认 每 种 cookie 的 订购 量 。 总 共 需 要 使 用 3 个 连接 才能 获取 
cookie 的 名 称 。 相 比 于 原始 的 SQL， 使 用 ORM 会 让 这 样 的 查询 变 得 更 容易 ( 见 示 例 7-26)。 


























示例 7-26 使 用 连接 查询 多 个 表 
query = session.query(Order.order id, User.username, User.phone, 
Cookie.cookie name, LineItem.quantity, 
LineItem.extended cost) 
query = query. join(User).join(LineItem).join(Cookie) © 
results = query.filter(User.username == 'cookiemon').all() 
print(results) 
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0 告诉 SQLAlchemy 连接 相关 对 象 。 
运行 示例 7-26， 会 得 到 如 下 结果 : 


[ 
(u'1', u'cookiemon', u'111-111-1111', u'peanut butter', 12, Decimal('3.00')), 
(u'1', u'cookiemon', u'111-111-1111', u'chocolate chip', 2, Decimal('1.00')) 
] 


此 外 ， 获 取 所 有 用 户 (包括 那些 当前 没有 订单 的 用 户 ) 的 订单 数量 也 很 有 用 。 为 此 ， 必 须 
使 用 outerjoin() 方法 ， 并 且 要 对 连接 顺序 多 加 注意 ， 因 为 应 用 outerjoin() 方法 的 表 将 
会 返回 所 有 结果 ( 见 示例 7-27). 


示例 7-27 使 用 外 连接 查询 多 个 表 
query = session.query(User.username, func.count(Order.order id)) 
query = query.outerjoin(Order).group by(User.username) 
for row in query: 
print(row) 



































运行 示例 7-27， 会 得 到 如 下 结果 : 


(u'cakeeater', 1) 
(u'cookiemon', 1) 
(u'pieperson', 0) 


到 目前 为 止 ， 我 们 一 直 在 查询 中 使 用 和 连接 不 同 的 表 。 但 是 ， 如 果 我 们 有 一 个 “ 自 引 用 ” 
的 表 ， 比 如 员工 和 老板 的 关系 表 ， 该 怎么 办 呢 ? ORM 允许 我 们 建立 指向 同一 个 表 的 关系 。 
不 过 ， 我 们 需要 指定 一 个 名 为 remote side 的 选项 ， 来 形成 多 对 一 的 关系 : 

















class Employee(Base): 
__tablename__ = 'employees' 


id = Column(Integer(), primary_key=True) 
manager id = Column(Integer(), ForeignKey('employees.id')) 


name - Column(String(255), nullable-False) 


manager = relationship("Employee", backref=backref('reports'), 
remote side-[id]) © 


Base.metadata.create all(engine) 
@ 创建 一 个 关系 ， 反 向 引用 同一 个 表 ， 指 定 remote_side， 形 成 多 对 一 的 关系 。 
接 下 来 ， 让 我 们 添加 两 个 雇员 ， 其 中 一 个 是 另 一 个 的 上 司 : 


marsha = Employee(name-'Marsha') 
fred = Employee(name-'Fred') 


marsha.reports.append(fred) 
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session.add(marsha) 
session.commit() 


现在 ， 如 果 想 打印 向 Marsha 报告 的 员工 ， 可 以 通过 访问 reports 属性 来 实现 ， 如 下 所 示 : 


for report in marsha.reports: 
print(report.name) 


做 数据 报表 时 ， 数 据 分 组 很 有 用 。 接 下 来 学 习 一 下 如 何 对 数据 进行 分 组 


7.7 分 组 


使 用 分 组 时 ， 你 需要 一 个 或 多 个 列 来 做 分 组 ， 以 及 一 个 或 多 个 列 来 做 统计 ， 比 如 计数 、 
求 和 等 ， 就 像 在 普通 SQL 中 所 做 的 那样 。 下 面 ， 让 我 们 按 客户 获得 订单 数量 ( 见 示例 
7-28)。 








示例 7-28 数据 分 组 
query = session.query(User.username, func.count(Order.order id)) © 
query = query.outerjoin(Order).group by(User.username) @ 
for row in query: 
print(row) 


@ 使 用 count() 统计 订单 数 。 
@ 根据 用 户 名 进行 分 组 。 








运行 示例 7-28， 会 得 到 如 下 结果 : 
(u'cakeeater', 1) 
(u'cookiemon', 1) 


(u'pieguy', 0) 


在 前 面 的 例子 中 ， 构 建 语句 时 ， 我 们 已 经 用 过 生成 方法 。 接 下 来 详细 讲 讲 。 


7.8” 链 式 调用 


ab n 多 次 用 过 链 式 调用 ， 只 是 没有 明说 。 构 建 查询 时 ， 如 果 你 想 把 逻辑 清晰 地 表 
出 来 ， 那 么 使 用 链 式 调用 会 特别 有 用 。 下 面 创建 一 个 函数 ， 让 其 为 我 们 获取 订单 数据 ， 
ums 7-29 所 示 。 









































示例 7-29 ” 链 式 调用 
def get orders by customer(cust name): 
query = session.query(Order.order id, User.username, User.phone, 
Cookie.cookie name, LineItem.quantity, 
LineItem.extended cost) 
query = query. join(User).join(LineItem) . join(Cookie) 
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results - query.filter(User.username -- cust name).all() 
return results 


get orders by customer('cakeeater') 





运行 示例 7-29， 会 得 到 如 下 结果 : 


[(u 2 ， 
(u'2', 


u'cakeeater', u'222-222-2222', u'chocolate chip', 24, Decimal('12.00')), 


u'cakeeater', u'222-222-2222', u'oatmeal raisin', 6, Decimal('6.00'))] 





但 是 ， 如 果 我 们 只 想 获得 那些 已 经 发 货 或 者 还 没有 发 货 的 订单 ， 该 怎么 办 呢 ? 为 此 ， 


编写 





其 他 函数 来 支持 额外 的 过 滤 选 项 ， 或 者 使 用 条 件 来 构建 查 





必须 


ie 另外 ， 我 们 可 能 还 需 


要 一 个 选项 ， 用 来 指定 是 否 包含 细节 。 利 用 这 种 把 查询 和 子 句 链 在 一 起 的 方法 ， 我 们 可 以 
做 出 功能 强大 的 报表 ， 以 及 构建 出 复杂 的 查询 〈 见 示例 7-30) 








示例 7-30” 带 条 件 的 链 式 调用 


def get orders by customer(cust name, shipped=None, details-False): 


query = session.query(Order.order id, User.username, User.phone) 
query = query. join(User) 
if details: 


query - query.add columns(Cookie.cookie name, LineItem.quantity, 
LineItem.extended cost) 
query = query.join(LineItem).join(Cookie) 


if shipped is not None: 


query = query.filter(Order.shipped == shipped) 


results = query.filter(User.username == cust name).all() 
return results 


print(get_orders_by_customer('cakeeater')) @ 

print(get_orders_by_customer('cakeeater', details=True)) @ 

print(get orders by customer('cakeeater', shipped=True)) © 

print(get orders by customer('cakeeater', shipped-False)) O 

print(get orders by customer('cakeeater', shipped-False, details=True))®@ 
获取 所 有 订单 。 
获取 所 有 订单 细节 。 
只 获取 已 经 
获取 还 没 发 货 的 订单 。 
获取 还 设 发 货 的 订单 细节 。 





货 的 订单 。 








行 示例 7-30， 会 得 到 如 下 结果 : 
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'222-222-2222', u'chocolate chip', 24, Decimal('12.00')), 
u'222-222-2222', u'oatmeal raisin', 6, Decimal('6.00'))] 
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'222-222-2222', u'chocolate chip', 24, Decimal('12.00')), 
u'222-222-2222', u'oatmeal raisin', 6, Decimal('6.00'))] 


c 


~ 





到 目前 为 止 ， 本 章 示 例 中 使 用 的 都 是 ORM。 共 实 你 也 可 以 使 用 原始 SQL 语句 ， 下 面 就 来 
有 具体 了 解 一 下 。 


7.9 ”原始 查询 


虽然 我 很 少 使 用 完全 原始 的 SQL 语句 ， 但 是 我 经 常 使 用 小 文本 片段 来 让 查询 变 得 更 清晰 。 
示例 7-31 是 使 用 原始 SQL where 子 句 的 例子 ， 其 中 用 到 了 text() 函数 。 

















示例 7-31 使 用 text() 函数 


from sqlalchemy import text 
query = session.query(User).filter(text("username='cookiemon'")) 
print(query.all()) 


运行 示例 7-31， 会 得 到 如 下 结果 : 


[User(username-'cookiemon', email address-'mon(cookie.com', 
phone='111-111-1111', password-'password')] 








现在 ， 你 应 该 学 会 了 如 何 使 用 ORM 处 理 SQLAlchemy 中 的 数据 。 我 们 学 习 了 创建 、 读 取 、 
更 新 和 删除 等 操作 。 到 这 里 ， 你 可 以 停 一 停 ， 多 做 一 些 尝试 ， 进 一 步 了 解 一 下 相关 内 容 ， 
然后 再 往 下 学 。 比 如 尝试 创建 更 多 cookie、 订 单 和 行 项 目 ， 使 用 查询 链 按 订单 和 用 户 进行 


分 组 。 

















当 你 对 本 章 内 容 有 了 更 为 深入 的 了 解 之 后 ， 就 可 以 继续 往 下 学 习 新 内 容 了 。 接 下 来 ， 让 我 
们 了 解 一 下 如 何 处 理 SQLAlchemy 抛 出 的 异常 ， 以 及 如 何 使 用 事务 对 语句 进行 分 组 。 
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上 一 章 中 我 们 学 习 了 大 量 与 会 话 相关 的 内 容 ， 并 且 回 避 了 那些 有 可 能 引发 异常 的 操作 。 本 
章 ， 我 们 会 进一步 学 习 有 关 对 象 和 SQLAlchemy 会 话 交互 的 内 容 。 本 章 最 后 ， 我 们 会 故意 
执行 一 些 错误 操作 ， 以 便 了 解 有 哪些 异常 类 型 以 及 如 何 处 理 它们 。 我 们 先 来 学 习 更 多 与 会 


话 有 关 的 内 容 。 首 先 ， 使 用 第 6 章 中 的 表 创 建 SQLite 内 存 数据 库 。 
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from sqlalchemy import create engine 
from sqlalchemy.orm import sessionmaker 


engine - create engine('sqlite:///:memory:') 

Session = sessionmaker (bind=engine) 

session = Session() 

from datetime import datetime 

from sqlalchemy import (Table, Column, Integer, Numeric, String, DateTime, 
ForeignKey, Boolean) 


from sqlalchemy.ext.declarative import declarative_base 
from sqlalchemy.orm import relationship, backref 


Base = declarative base() 


class Cookie(Base): 
__tablename__ = 'cookies' 


cookie_id = Column(Integer, primary_key=True) 
cookie_name = Column(String(50), index=True) 


cookie recipe url = Column(String(255)) 
cookie sku = Column(String(55)) 
quantity = Column(Integer()) 

unit cost - Column(Numeric(12, 2)) 


def _ init (self, name, recipe url-None, sku=None, quantity=0, 
unit cost-0.00): 
self.cookie name - name 
self.cookie recipe url - recipe url 
self.cookie sku = sku 
self.quantity - quantity 
self.unit cost - unit cost 


def repr (self): 
return "Cookie(cookie_name='{self.cookie_name}', " X 


"cookie recipe url-'([self.cookie recipe url]', " \ 


"cookie sku-'[self.cookie skuj', " \ 
"quantity={self.quantity}, " V 
"unit cost-(self.unit cost])".format(self-self) 


class User(Base): 
__tablename__ = 'users' 


user_id = Column(Integer(), primary_key=True) 

username = Column(String(15), nullable-False, unique=True) 
email address = Column(String(255), nullable-False) 

phone = Column(String(20), nullable-False) 

password = Column(String(25), nullable-False) 

created on - Column(DateTime(), default-datetime.now) 


updated on = Column(DateTime(), default=datetime.now, onupdate-datetime.now) 


def _ init (self, username, email address, phone, password): 
self.username - username 
self.email address - email address 
self.phone = phone 
self.password - password 


def repr (self): 
return "User(username='{self.username}', " \ 
"email address-'([self.email address)', " X 
"phone='{self.phone}', " X 
"password='{self.password}')".format(self=self) 


class Order(Base): 
__tablename__ = 'orders' 
order_id = Column(Integer(), primary_key=True) 
user_id = Column(Integer(), ForeignKey('users.user_id')) 
shipped = Column(Boolean(), default=False) 


user = relationship("User", backref=backref('orders', order byzorder id)) 


def repr (self): 
return "Order(user id-(self.user id), " V 
"shipped={self.shipped})".format(self=self) 
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class LineItem(Base): 
__tablename__ = 'line items' 
line item id = Column(Integer(), primary key-True) 
order id = Column(Integer(), ForeignKey('orders.order id')) 
cookie id = Column(Integer(), ForeignKey('cookies.cookie id')) 
quantity - Column(Integer()) 
extended cost - Column(Numeric(12, 2)) 


order = relationship("Order", backref-backref('line items', 
order by-line item id)) 
cookie = relationship("Cookie", uselist=False) 


def repr (self): 
return "LineItems(order id-[self.order id), " V 
"cookie id-[self.cookie id), " V 
"quantity={self.quantity}, " V 
"extended cost-(self.extended cost])".format( 
self-self) 


Base.metadata.create all(engine) 





我 们 已 经 定义 好 了 初始 数据 库 和 对 象 ， 接 下 来 可 以 进一步 学 习 会 话 如 何 与 对 象 交 互 了 。 


8.1 ts 


第 7 章 中 已 经 介绍 些 与 SOLAlchemy 会 话 相 关 的 内 容 ， 这 里 重点 讲 讲 数据 对 象 是 如 何 
与 会 话 交互 的 。 


当 使 用 查询 获取 对 象 时 ， 会 得 到 一 个 和 会 话 相 连 的 对 象 。 这 个 对 象 会 在 会 话 的 几 个 状态 中 
切换 。 

会 话 状 态 

了 解 会 话 状 态 对 于 排除 异常 和 处 理 异 常 行为 很 有 用 。 数 据 对 象 实例 有 四 种 可 能 的 状态 。 





transient 瞬时 状态 ) 
实例 不 在 会 话 中 ， 也 不 在 数据 库 中 。 


pending 〈 挂 起 状态 ) 
实例 由 add) 方法 添加 到 会 话 中 ,但 仍 未 刷新 或 提交 。 


persistent (持久 化 状态 ) 
会 话 中 的 对 象 在 数据 库 中 有 对 应 的 记录 。 


detached 〈 脱 管状 态 ) 
实例 不 再 与 会 话 相 连 ， 但 在 数据 库 中 仍然 有 一 条 记录 。 














当 使 用 某 个 实例 时 ， 我 们 可 以 观察 到 它 在 这 些 状态 之 间 转 换 。 先 来 创建 一 个 Cookie 的 实例 : 








cc cookie = Cookie('chocolate chip', 
'http://some.aweso.me/cookie/recipe.html', 
'CCO1', 12, 0.50) 


为 了 查看 实例 的 状态 ， 可 以 使 用 SQLAIchemy 提供 的 功能 强大 的 inspect() 方法 。 当 在 一 个 
实例 上 应 用 inspect() 方法 时 ， 可 以 访问 一 些 有 用 的 信息 。 下 面 检查 一 下 cc_cookie 实例 : 





from sqLaLchemy import inspect 

insp = inspect(cc cookie) 
本 例 中 ， 我 们 关注 的 是 表示 当前 状态 的 transient, pending, persistent, detached 属性 。 
让 我 们 循环 遍历 这 些 属 性 ， 如 示例 8-1 所 示 。 


示例 8-1 获取 实例 的 会 话 状 态 
for state in ['transient', 'pending', 'persistent', 'detached']: 
print('{:>10}: {}'.format(state, getattr(insp, state))) 











运行 示例 8-1 会 得 到 一 系列 状态 ， 其 中 布尔 值 表示 哪个 是 当前 状态 。 














transient: 
pending: 
persistent: 
detached: 


从 上 面 的 输出 可 
或 提交 到 数据 库 之 前 新 创建 的 对 象 所 处 的 状态 
重新 运行 示例 8-1， 





transient: 
pending: 
persistent: 
detached: 


现在 ， 我 们 已 经 把 cookie 实例 添加 到 当前 会 
如 果 提 交会 话 ， 然 后 再 次 运行 示例 8-1， 就 可 以 看 到 ] 


了 pending, 


transient: 
pending: 
persistent: 
detached: 





True 

False 
False 
False 


以 看 到 ，cookie 实例 的 当前 状态 是 








将 得 到 以 下 输出 : 


False 
True 

False 
False 


False 
False 
True 

False 


“瞬时 状态 ”(transient)， 这 是 在 刷新 




















。 如 果 


话 中 了 ， 可 以 看 到 


在 当前 会 话 中 添加 cc_cookie， 然 后 








比 当前 
其 状态 


状态 由 transient 变 成 
又 变 成 了 persistent; 








后 ， 为 了 让 cc_cookie 进入 脱 管状 态 ， 需 要 调用 会 话 的 expunge() 方法 。 当 你 想 把 数据 
从 一 个 会 话 移 到 另 一 个 会 话 时 ， 可 能 需要 这 样 做 。 而 你 希望 把 数据 从 一 个 会 话 移 到 另 一 个 
会 话 的 一 种 情况 是 ， 你 想 把 主要 数据 库 中 的 数据 归档 或 合并 到 数据 仓库 : 








session.expunge(cc cookie) 
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执行 上 面 这 行 代码 后 ， 重 新 运行 示例 8-1， 你 会 看 到 cc cookie 进入 了 脱 管状 态 。 











transient: False 
pending: False 
persistent: False 
detached: True 





在 普通 代码 中 使 用 inspectO 方法 时 ， 你 可 能 会 使 用 insp.transient、iinsp.pending、iinsp. 
persistent 和 insp.detached 获取 各 个 状态 的 情况 。 而 这 里 ， 我 们 使 用 getattr() 方法 来 
访问 它们 ， 这 样 就 可 以 遍历 这 些 状 态 ， 而 不 必 分 别 对 每 个 状态 进行 硬 编码 。 


现在 ， 我 们 已 经 知道 一 个 对 象 如 何在 各 种 会 话 状态 中 切换 。 接 下 来 看 看 如 何 使 用 insp 在 提 
交 实 例 之 前 查看 它 的 历史 记录 。 首 先 ， 把 对 象 添 加 回 会 话 并 更 改 cookie name 属性 : 




















session.add(cc cookie) 
cc cookie.cookie name = 'Change chocolate chip' 


接着 ， 通 过 insp 的 modifed 属性 ， 查 看 实例 对 象 是 否 发 生 了 更 改 。 





insp.modified 

















运行 结果 为 True。 我 们 还 可 以 使 用 insp 的 attrs 集合 来 查看 发 生 了 什么 变化 ， 如 示例 8-2 
所 示 。 


示例 8-2 打印 属性 更 改 历 史 
for attr, attr state in insp.attrs.items(): 
if attr state.history.has changes(): © 
print('{}: {}'.format(attr, attr state.value)) 
print('History: {}\n'.format(attr_state.history)) O 


@ 检查 属性 状态 ， 看 看 会 话 是 否 能 发 现 变化 。 
@ 打印 有 更 改 的 属性 的 history HR, 


运行 示例 8-2， 会 得 到 如 下 结果 : 


cookie name: Change chocolate chip 
History: History(added-['Change chocolate chip'], unchanged=(), deleted=()) 


从 示例 8-2 的 输出 结果 可 以 看 到 ，cookie_name 发 生 了 变化 。 当 查看 这 个 属性 的 历史 记录 
时 ， 可 以 看 到 该 属性 上 添加 或 更 改 了 什么 。 这 帮助 我 们 了 解 了 对 象 是 如 何 和 会 话 交互 的 。 
接 下 来 学 习 如 何 处 理 使 用 SQLAlchemy ORM 的 过 程 中 出 现 的 异常 。 














8.2 异常 


SQLAlchemy 中 可 能 发 生 的 异常 有 很 多 ,但 这 里 重点 讲 讲 MultipleResultsFound 和 


lim] 
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DetachedInstancetrror 两 种 异常 。 这 两 个 异常 很 常见 ， 也 是 一 组 类 似 异 常 的 一 部 分 。 学 会 
了 处 理 这 些 异常 的 方法 ， 你 就 能 轻松 地 处 理 遇 到 的 其 他 异常 了 。 





8.2.1 MultipleResultsFound 异 常 


在 使 用 .one() 查询 方法 时 ， 如 果 返 回 了 多 个 结果 ， 就 会 发 生 MultipleResultsFound 异常 。 
为 了 演示 这 个 异常 ， 我 们 需要 先 创建 另外 一 个 cookie 并 将 其 保存 到 数据 库 中 : 


























dcc = Cookie('dark chocolate chip', 
'http://some.aweso.me/cookie/recipe dark.html', 
'CC02', 1, 0.75) 

session.add(dcc) 

session.commit() 


现在 ， 数 据 库 中 已 经 有 多 个 cookie 了 ， 接 下 来 触发 MultipleResultsFound 异常 〈( 见 示例 8-3). 





示例 8-3 ”触发 MultipleResultsFound 异常 

results = session.query(Cookie).one() 
运行 示例 8-3 会 发 生 异 常 ， 因 为 我 们 的 数据 产 中 有 两 个 cookie 与 查询 相 匹 配 。 异 常会 停止 
程序 的 执行 。 示 例 8-4 显示 了 这 个 异常 的 信息 。 





示例 8-4 MultipleResultsFound 异常 的 信息 


MultipleResultsFound Traceback (most recent call last) © 
<ipython-input-20-d88068ecde4b> in <module>() 
----> 1 results = session.query(Cookie).one() @ 


...b/python2.7/site-packages/sqlalchemy/orm/query.pyc in one(self) 


2480 else: 
2481 raise orm exc.MultipleResultsFound( 

-» 2482 "Multiple rows were found for one()") 
2483 


2484 def scalar(self): 
MultipleResultsFound: Multiple rows were found for one() © 

@ 这 行 显示 了 异常 类 型 和 错误 跟踪 。 
@ 这 是 触发 异常 的 代码 行 。 
e 这 是 需要 我 们 关注 的 部 分 。 

示例 8-4 显示 的 是 SOLAlchemy 中 MultipleResultsFound 异常 的 标准 格式 。 第 一 行 指 出 异 
常 类 型 。 接 下 来 是 异常 跟踪 ， 指 出 异常 发 生 的 位 置 。 最 后 一 行 提供 了 重要 细节 ， 其 中 不 仅 
引出 了 异常 类 型 ， 还 表明 了 发 生 异 常 的 原因 。 本 例 中 ， 我 们 要 求 查询 只 返回 一 行 ， 而 实际 
却 返 回 了 两 行 ， 从 而 引发 了 MultipleResultsFound 异常 。 
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另 一 个 相关 异常 是 NoResultFound。 当 我 们 使 用 .one() 方法 进行 查询 时 ， 如 
果 查 询 没 有 返回 任何 结果 ， 就 会 触发 NoResuLtFound 异常 。 





如 果 想 处 理 这 个 异常 ， 让 程序 不 会 因此 而 停止 执行 ， 并 打印 出 更 有 用 的 异常 消息 ， 可 以 使 
FA Python 的 try/except 块 ， 如 示例 8-5 所 示 。 


示例 8-5 ”处理 MultipleResultsFound 异常 
from sqlalchemy.orm.exc import MultipleResultsFound @ 
try: 
results - session.query(Cookie).one() 
except MultipleResultsFound as error: @ 
print('We found too many cookies... is that even possible?') 


0 所 有 SQLAlchemy ORM 异常 都 在 sqlalchemy orm. exc 模块 中 。 
O 捕获 MultipleResultsFound 异常 ， 并 为 其 定义 别名 为 error。 



































运行 示例 8-5 会 输出 “We found too many cookies... is that even possible?” 这 样 一 条 信息 ， 
同时 我 们 的 应 用 程序 会 继续 正常 运行 。( 我 认为 不 可 能 找到 太 多 cookie.) 现在 ， 你 已 经 了 
解 了 MultipleResultsFound 异常 ， 并 且 至 少 学 会 了 一 种 处 理 方法 ， 同 时 还 能 够 保证 程序 可 
以 继续 执行 下 去 。 





8.2.2 DetachedInstanceError 

当 尝 试 访问 某 个 实例 的 某 个 属性 时 ， 如 果 这 个 实例 需要 从 数据 库 加 载 ， 但 它 目 前 又 没有 连 
接 到 数据 库 ， 就 会 发 生 DetachedInstanceError 异常 。 在 讲解 这 个 异常 之 前 ， 需 要 先 创 建 
要 操作 的 记录 。 示 例 8-6 演示 了 具体 做 法 。 





示例 8-6 ”创建 一 个 用 户 和 订单 
cookiemon = User('cookiemon', 'mon@cookie.com', '111-111-1111', 'password') 
session.add(cookiemon) 
01 = Order() 
o1.user = cookiemon 
session.add(o1) 


cc = session.query(Cookie).filter(Cookie.cookie name == 
"Change chocolate chip").one() 
linei = LineItem(order=01, cookie=cc, quantity=2, extended_cost=1.00) 


session.add(line1) 
session.commit() 


HE, 我们 已 经 创建 好 了 一 个 用 户 ， 他 对 应 于 一 个 订单 和 若干 行 项 。 到 这 里 ， 触 
发 DetachedInstanceError 异常 的 准备 工作 就 做 好 了 。 示 例 8-7 演 示 了 如 何 触 发 


DetachedInstanceError 异常 。 
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示例 8-7 触发 DetachedInstanceError 异常 


order = session.query(Order).first() 
session.expunge(order) 
order.line items.all() 





在 示例 8-7 中 ， 我 们 通过 查询 获取 一 个 order 实例 。 有 了 这 个 实例 之 后 ， 我 们 又 使 用 


expunge() 把 它 从 会 话 中 分 离 出 来 。 然 后 尝试 加 载 Vine items 属性 。 因 为 line items 是 一 
个 关系 ， 所 以 默认 情况 下 ， 在 你 请 求 数据 之 前 ， 它 是 不 会 加 载 所 有 数据 的 。 本 例 中 ， 我 们 
把 实例 从 会 话 中 分 离 了 ， 关 系 缺 少 会 话 来 执行 查询 从 而 加 载 Line_items 属性 ， 这 时 就 会 引 
发 DetachedInstanceError 异常 。 

















DetachedInstanceError Traceback (most recent call last) 
«ipython-input-35-233bbca5c715» in <module>() 


1 order = session.query(Order).first() 
2 session.expunge(order) 


----» 3 order.line items Q 


site-packages/sqlalchemy/orm/attributes.pyc in _ get (self, instance, owner) 


235 return dict [self.key] 
236 else: 
--» 237 return self.impl.get(instance state(instance), dict ) 
238 
239 


site-packages/sqlalchemy/orm/attributes.pyc in get(self, state, dict , passive) 


576 value = callable (state, passive) 
577 elif self.callable : 
--» 578 value = self.callable (state, passive) 
579 else: 
580 value - ATTR EMPTY 


site-packages/sqlalchemy/orm/strategies.pyc in load for state(self, state, 


passive) 

499 "Parent instance %s is not bound to a Session; " 

500 "lazy load operation of attribute '%s' cannot proceed" % 
--» 501 (orm util.state str(state), self.key) 

502 ) 

503 


DetachedInstanceError: Parent instance «Order at 0x10dc31350> is not bound to 
a Session; lazy load operation of attribute 'line items' cannot proceed @ 


0 引发 异常 的 代码 。 
@ 这 是 我 们 要 关注 的 部 分 。 








和 示例 8-5 一 样 ， 我 们 阅读 异常 输出 的 信息 ， 其 中 指出 ， 我 们 试图 加 载 order 实例 的 Line_ 
items 属性 ， 但 无 法 做 到 这 一 点 ， 因 为 该 实例 并 没有 绑 定 到 会 话 。 


虽然 上 





HHY DetachedInstanceError 异常 是 我 们 有 意 触发 的 ， 但 它 的 行为 和 其 他 异常 非常 相 














理解 会 话 和 异常 | 95 


似 ， 比 如 ObjectDeletedError, StaleDataError 和 ConcurrentModificationError, fit Aix 
些 异 常 都 与 实例 、 会 话 和 数据 库 之 间 的 信息 不 一 致 有 关 。 示 例 8-6 中 使 用 try/except 块 处 
理 异 常 的 方法 也 适用 于 这 些 异 常 ， 这 种 处 理 方法 允许 代码 继续 运行 。 你 可 以 把 已 分 离 的 实 
例 放 入 try 块 中 检查 ， 并 在 except 块 中 将 其 添加 回 会 话 中 。 不 过 ，DetachedInstanceError 
通常 表明 在 代码 的 这 个 地 方 之 前 就 发 生 了 异常 。 
































关于 ORM 异常 的 更 多 细节 ， 请 参阅 SQLAlchemy 文档 。 


到 目前 为 止 ， 我 们 提 到 的 所 有 异常 (比如 MultipleResultsFound 和 DetachedInstanceError ) 
都 和 某 一 条 语句 的 执行 失败 有 关 。 如 果 有 多 个 语句 ， 比 如 在 提交 或 刷新 期 间 执行 失败 的 多 
个 添加 或 删除 语句 ， 就 需要 使 用 不 同 的 方式 来 处 理 它们 。 具 体 来 说 就 是 通过 手动 控制 事务 
来 处 理 它们 。 下 一 市 将 详细 讲解 有 关 事 务 的 内 容 ， 期 间 会 教 你 如 何 使 用 事务 来 帮助 处 理 异 
常 和 恢复 会 话 。 


8.3 事务 


事务 是 一 组 语句 ， 这 组 语句 被 看 成 一 个 整体 ， 其 执行 要 么 全 部 成 功 ， 要 么 全 部 失败 。 当 我 
们 第 一 次 创建 会 话 时 ， 它 并 没有 连接 到 数据 库 。 当 我 们 对 会 话 执行 第 一 个 操作 (比如 查 
i) 时 ， 它 会 启动 一 个 连接 和 一 个 事务 。 也 就 是 说 ， 上 默认 情况 下 ， 我 们 不 需要 手动 创建 事 
务 。 但 是 ， 如 果 我 们 要 处 理 的 异常 中 ， 事 务 的 一 部 分 执行 成 功 而 另 一 部 分 执行 失败 ， 或 者 
事务 结果 引发 了 异常 ， 这 种 情况 下 ， 我 们 就 必须 知道 如 何 手 动 控制 事务 。 


下 面 举例 说 明 什 么 时 候 需 要 在 当前 数据 库 中 这 样 做 。 当 一 位 客户 向 我 们 订购 了 cookie 之 
后 ， 我 们 需要 把 指定 的 cookie 发 送 给 客户 ， 然 后 把 它们 从 库存 中 删除 。 但 是 ， 如 果 我 们 没 
有 足够 的 cookie 来 完成 这 笔 订单 呢 ?” 这 时 ， 我 们 需要 先 查 看 库存 ， 而 不 是 执行 订单 。 可 以 
使 用 事务 来 解决 这 个 问题 。 


我 们 需要 新 开 一 个 Python shell， 创 建 一 些 数 据 表 ， 这 里 使 用 第 6 章 中 的 表 。 但 是 ， 我 
们 要 向 quantity 列 添加 CheckConstraint， 这 样 可 以 确保 它 不 会 小 于 0， 因 为 库存 中 的 
cookie 不 可 能 是 负数 。 接 下 来 ， 重 新 创建 cookiemon 用 户 以 及 chocolate chip cookie 和 dark 
chocolate chip cookie 记录 ， 把 chocolate chip cookie 的 数量 设置 为 12 块 ， 把 dark chocolate 
chip cookie 的 数量 设置 为 1 块 。 示 例 8-8 演示 了 具体 的 操作 步骤 。 


示例 8-8 建立 事务 环境 
from sqlalchemy import create engine 
from sqlalchemy.orm import sessionmaker 






























































engine = create engine('sqlite:///:memory:') 
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Session = sessionmaker(bind-engine) 
session - Session() 
from datetime import datetime 


from sqlalchemy import (Table, Column, Integer, Numeric, String, 
DateTime, ForeignKey, Boolean, CheckConstraint) 

from sqlalchemy.ext.declarative import declarative base 

from sqlalchemy.orm import relationship, backref 


Base - declarative base() 


class Cookie(Base): 
__tablename__ = 'cookies' 
. table args . = (CheckConstraint('quantity >= 0', name='quantity_positive'),) © 


cookie_id = Column(Integer, primary_key=True) 
cookie_name = Column(String(50), index=True) 
cookie recipe url = Column(String(255)) 
cookie sku = Column(String(55)) 

quantity - Column(Integer()) 

unit cost - Column(Numeric(12, 2)) 


def _ init (self, name, recipe url-None, sku=None, quantity-0, unit cost-0.00): 
self.cookie name - name 
self.cookie recipe url - recipe url 
self.cookie sku = sku 
self.quantity - quantity 
self.unit cost - unit cost 


def repr (self): 
return "Cookie(cookie_name='{self.cookie_name}', " \ 
"cookie recipe url-'([self.cookie recipe url]', " \ 
"cookie sku-'[self.cookie skuj', " \ 
"quantity={self.quantity}, " \ 
"unit cost-(self.unit cost]))".format(self-self) 


class User(Base): 
__tablename__ = 'users' 


user_id = Column(Integer(), primary_key=True) 

username = Column(String(15), nullable-False, unique-True) 

email address - Column(String(255), nullable-False) 

phone = Column(String(20), nullable-False) 

password = Column(String(25), nullable-False) 

created on - Column(DateTime(), default-datetime.now) 

updated on - Column(DateTime(), default-datetime.now, onupdate-datetime.now) 


def _ init__(self, username, email address, phone, password): 
self.username - username 
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self.email address - email address 
self.phone = phone 
self.password - password 


def repr (self): 
return "User(username='{self.username}', " X 
"email address-'(self.email address)', " V 
"phone='{self.phone}', " V 
"password='{self.password}')".format(self=self) 


class Order(Base): 
__tablename__ = 'orders' 
order_id = Column(Integer(), primary_key=True) 
user id = Column(Integer(), ForeignKey('users.user id')) 
shipped - Column(Boolean(), default-False) 


user = relationship("User", backref=backref('orders', order by-order id)) 


def repr (self): 
return "Order(user id-(self.user id), " V 
"shipped={self.shipped})".format(self=self) 


class LineItem(Base): 
__tablename__ = 'line items' 
line item id = Column(Integer(), primary_key=True) 
order id = Column(Integer(), ForeignKey('orders.order id')) 
cookie id = Column(Integer(), ForeignKey('cookies.cookie id')) 
quantity - Column(Integer()) 
extended cost - Column(Numeric(12, 2)) 


order = relationship("Order", backref-backref('line items', 
order by-line item id)) 
cookie - relationship("Cookie", uselist-False) 


def repr (self): 
return "LineItem(order id-(self.order id), " \ 
"cookie id-(self.cookie id), " V 
"quantity={self.quantity}, " V 
"extended cost-(self.extended cost])".format( 
self=self) 


Base.metadata.create_all(engine) 


cookiemon = User('cookiemon', 'mon@cookie.com', '111-111-1111', 'password') @ 

cc = Cookie('chocolate chip', 'http://some.aweso.me/cookie/recipe.html', © 
'CCO1', 12, 0.50) 

dcc = Cookie('dark chocolate chip', @ 
'http://some.aweso.me/cookie/recipe dark.html', 
'CCO2', 1, 0.75) 


session.add(cookiemon) 
session.add(cc) 
session.add(dcc) 








添加 数量 为 正 的 检查 约束 (CheckConstraint), 
添加 cookiemon 用 户 。 





0 
e 
© 添加 chocolate chip cookie, 
o 


添加 dark chocolate chip cookie, 


#2 PH, 4% cookiemon 用 户 定义 两 个 订单 。 第 一 个 订单 是 9 EK chocolate chip cookie, 55 — 
个 订单 是 2 块 chocolate chip cookie 和 9 块 dark chocolate chip cookie。 示 例 8-9 显示 了 添加 
订单 的 代码 。 











示例 8-9 添加 订单 
o1 = Order() 


o1.user = cookiemon 
session.add(o1) 


line1 = LineItem(order-o1, cookie=cc, quantity-9, extended cost-4.50) 


session.add(line1) 
session.commit() @ 
02 = Order() 
02.user = cookiemon 
session.add(o2) 


line1 = LineItem(order-o2, cookie-cc, quantity=2, extended cost-1.50) 
line2 = LineItem(order-o2, cookie-dcc, quantity-9, extended cost-6.75) 


session.add(line1) 
session.add(line2) 
session.commit() O 


@ 添加 第 一 个 订单 。 
e 添加 第 二 个 订单 。 























有 了 这 些 订单 数据 ， 我 们 就 可 以 学 习 事 务 的 工作 原理 了 。 我 们 先 要 定义 一 个 名 为 ship it 
的 函数 。 这 个 ship it 函数 接受 一 个 order id 参数 ， 它 会 从 库存 中 删除 cookie， 并 把 订单 
标记 为 “已 发 货 ”。 示 例 8-10 是 ship it 函数 的 定义 代码 。 








示例 8-10 定义 ship it 函数 
def ship it(order id): 

order = session.query(Order).get(order id) 

for li in order.line items: 
li.cookie.quantity = li.cookie.quantity - li.quantity © 
session.add(li.cookie) 

order.shipped = True @ 

session.add(order) 

session.commit() 

print("shipped order ID: {}".format(order_id)) 
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@ 对 于 订单 中 的 每 个 行 项 ， 我 们 都 会 从 相应 cookies 表 的 quantity 列 中 删除 行 项 指定 的 
数量 ， 这 样 就 可 以 知道 还 剩 下 多 少 cookie, 


e 更 新 订单 ， 将 其 标记 为 “已 发 货 。 














ee 个 订单 ，ship_it 函数 就 会 执行 所 有 必需 的 操作 。 我 们 对 第 一 个 订单 运行 
个 函数 ， 然 后 查询 cookies 表 ， 确 保 它 正确 地 减少 了 cookie 的 数量 。 示 例 8-11 展示 了 具 
nis 








示例 8-11 对 第 一 个 订单 运行 shtp_it 函数 
ship it(1) © 
print(session.query(Cookie.cookie name, Cookie.quantity).all()) O 


@ 对 第 一 个 order_id 运行 ship_it 国 数 。 
@ 查看 库存 。 




















运行 示例 8-11 ， 会 得 到 如 下 结果 : 


shipped order ID: 1 
[(u'chocolate chip', 3), (u'dark chocolate chip', 1)] 


太 好 了 ! ship it 函数 工作 正常 。 从 执行 结果 中 可 以 看 到 ， 库 存 中 设 有 足够 的 cookie 来 完 
成 第 二 个 订单 。 不 过 ， 在 工作 市 奏 很 快 的 仓库 中 ， 这 两 个 订单 可 能 会 被 同时 处 理 。 现 在 党 
试 使 用 ship_it 函数 完成 第 二 个 订单 ， 代 码 如 下 : 











ship_it(2) 





执行 结果 如 下 : 


IntegrityError Traceback (most recent call last) 
«ipython-input-7-8a7f7805a7f6» in <module>() 

--» 1 ship it(2) 
«ipython-input-5-c442ae46326c» in ship it(order id) 


6 order.shipped - True 
7 session.add(order) 
--> 8 session.commit() 
9 print("shipped order ID: {}".format(order_id)) 


IntegrityError: (sqlite3.IntegrityError) CHECK constraint failed: 
quantity positive [SQL: u'UPDATE cookies SET quantity-? WHERE 
cookies.cookie id - ?'] [parameters: (-8, 2)] 


由 于 我 们 没有 足够 的 dark chocolate chip cookie 完成 订单 ， 所 以 最 终 得 到 了 一 个 Integrity- 


Error 错误 。 这 实际 上 会 中 断 我 们 当前 的 会 话 。 如 果 尝 试 通过 会 话 发 送 更 多 语句 (比如 查 
询 ) 来 获取 cookie 的 列表 ， 将 会 得 到 示例 8-12 所 示 的 输出 。 





示例 8-12: 通过 错误 会 话 查询 


print(session.query(Cookie.cookie name, Cookie.quantity).all()) 


InvalidRequestError Traceback (most recent call last) 
«ipython-input-8-90b93364fb2d» in <module>() 
---» 1 print(session.query(Cookie.cookie name, Cookie.quantity).all()) 


InvalidRequestError: This Session's transaction has been rolled back due to a 
previous exception during flush. To begin a new transaction with this Session, 
first issue Session.rollback(). Original exception was: (sqlite3.IntegrityError) 
CHECK constraint failed: quantity positive [SQL: u'UPDATE cookies SET 
quantity-? WHERE cookies.cookie id - ?'] [parameters: ((1, 1), (-8, 2))] 





去 除 里 面 的 跟踪 细节 ， 可 以 发 现 是 前 面 的 IntegrityError 引发 了 InvalidRequestError 5E 
第 。 要 从 这 个 会 话 状 态 中 恢复 ， 需 要 手动 回 滚 事务 。 示 例 8-12 中 显示 的 信息 可 能 有 点 令 人 
困惑 ， 因 为 里 面 提 到 了 “This Session's transaction has been rolled back" (这 个 会 话 的 事务 已 
回 矫 ) ， 但 它 实 际 上 是 让 你 手动 执行 回 深 。 调 用 会 话 的 roLLback() 方法 可 以 把 会 话 恢 复 过 
来 。 每 当 遇 到 异常 ， 你 都 可 以 调用 rollback() 方法 进行 回 滚 : 






































session.rollback() 
print(session.query(Cookie.cookie name, Cookie.quantity).all()) 


这 段 代码 会 像 我 们 预料 的 那样 正常 输出 结果 : 
[(u'chocolate chip', 3), (u'dark chocolate chip', 1)] 


在 会 话 正常 工作 的 情况 下 ， 可 以 使 用 try/except 块 ， 确 保 当 IntegrityError 异常 发 生 时 将 
打印 一 条 信息 并 回 滚 事务 ， 这 样 应 用 程序 就 可 以 继续 正常 工作 了 ， 如 示例 8-13 所 示 。 

















示例 8-13 事务 型 ship_it 
from sqlalchemy.exc import IntegrityError © 
def ship it(order id): 
order = session.query(Order).get(order id) 
for li in order.line items: 
li.cookie.quantity - li.cookie.quantity - li.quantity 
session.add(li.cookie) 
order.shipped - True 
session.add(order) 
try: 
session.commit() 
print("shipped order ID: {}".format(order_id)) 
except IntegrityError as error: € 
print('ERROR: {!s}'.format(error.orig)) 
session.rollback() © 


© 导入 IntegrityError， 以 便 处 理 这 个 异常 。 
O 若 无 异 常 发 生 ， 提 交 事 务 。 
e 若 有 异常 发 生 ， 回 深 事 务 。 
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下 面 针 对 第 二 个 订单 重新 运行 基于 事务 的 ship_it， 如 下 所 示 : 











ship it(2) 
ERROR: CHECK constraint failed: quantity positive 


程序 不 会 因为 异常 而 停止 ， 它 会 打印 错误 信息 ， 但 不 会 显示 异常 跟踪 细节 。 让 我 们 使 用 示 
例 8-12 中 的 代码 查看 一 下 库存 ， 确 保 它 不 会 因 发 送 一 部 分 cookie 而 搞 乱 库存 : 


[(u'chocolate chip', 3), (u'dark chocolate chip', 1)] 


KET! RRES TO ARGA ELETRE PB Re RAE. SO AN i EP ADAE 
量 代码 以 便 回 滚 到 之 前 的 状态 。 如 你 所 见 ， 事 务 在 这 种 情况 下 非常 有 用 ， 并 且 使 用 它 可 以 
大 大 减少 手动 编码 的 工作 量 。 


本 章 我 们 学 习 了 单行 语句 和 多 行 语句 的 异常 处 理 方 法 。 通 过 在 单行 语句 上 添加 普通 的 try/ 

except 块 ， 可 以 防止 应 用 程序 在 磁 到 数据 库 语句 执行 错误 时 发 生 崩 福 。 我 们 还 学 习 了 会 话 

epee geen 致 问题 ， 以 及 当 一 组 语句 组 执行 失败 时 如 何 防 止 程序 发 生 月 
。 下 一 章 中 ， 我 们 将 学 习 测 试 代码 的 方法 ， 以 便 确保 代码 的 行为 符合 我 们 的 预期 。 

















BIS 


使 用 SQLAIchemy 0RM 测 试 





应 用 程序 测试 大 都 包括 单元 测试 和 功能 测试 两 部 分 。 但 是 ， 在 使 用 SQLAlchemy 做 单元 测 
试 时 ， 要 正确 地 模拟 一 条 查询 语句 或 者 一 个 模型 可 能 需要 做 很 多 工作 。 在 对 数据 库 做 功能 
测试 时 ， 这 些 工 作 通常 不 会 带 来 多 大 好 处 。 所 以 ， 一 般 人 们 会 为 能 在 单元 测试 期 间 轻 松 模 
拟 的 查询 创建 包装 器 ， 或 者 在 单元 测试 和 功能 测试 中 均 只 针对 数据 库 做 测试 。 我 个 人 比较 
喜欢 使 用 小 巧 的 包装 器 函数 ， 但 是 如 果 出 于 某 种 原因 使 得 这 样 做 没有 意义 ， 或 者 处 理 的 是 
遗留 代码 ， 那 我 会 选择 使 用 模拟 方法 。 


本 章 讲解 如 何 对 数据 库 做 功能 测试 ， 以 及 如 何 模 拟 SOLAlchemy 查询 和 连接 。 


9.1 使 用 测试 数据 库 做 测试 


在 我 们 的 示例 程序 中 ， 有 一 个 app.py 文 件 ， 其 中 包含 应 用 程序 逻辑 ， 还 有 一 个 db.py 文 
件 ， 其 中 包含 我 们 的 数据 模型 和 会 话 。 你 可 以 在 CH09/ 文件 夹 中 找到 这 些 文件 。 














应 用 程序 的 结构 会 对 测试 方式 产生 很 大 影响 。 在 db.py 文件 中 ， 你 可 以 看 到 我 们 的 数据 库 
是 通过 DataAccessLayer 类 建立 的 。 我 们 使 用 这 个 数据 访问 类 随时 初始 化 数据 库 引 擎 和 会 
话 。 在 与 SQLAlchemy 结合 使 用 的 Web 框架 中 ,你 会 经 常 看 到 这 种 模式 。DataAccessLayer 
类 初始 化 时 ，dal 变量 中 并 不 存在 引擎 和 连接 。 


虽然 我 们 在 示例 中 使 用 SQLite 数据 库 进行 测试 ， 但 是 强烈 建议 你 在 生产 环境 
中 使 用 相同 的 数据 库 引 擎 进行 测试 。 如 果 你 在 测试 中 使 用 了 不 同 的 数据 库 ， 
那么 一 些 可 以 在 SQLite 中 使 用 的 约束 和 语句 可 能 在 其 他 数据 库 上 无 法 正常 
工作 ， 比 如 PostgreSQL. 
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示例 9-1 显示 的 是 db.py 文件 中 的 一 个 片段 一 一 DataAccessLayer 类 。 


示例 9-1 DataAccessLayer 类 
from sqlalchemy.ext.declarative import declarative base 


Base - declarative base() 


class DataAccessLayer: 


def init (self): © 
self.engine - None 
self.conn string - 'some conn string' 


def connect(self): O 
self.engine - create engine(self.conn string) 
Base.metadata.create all(self.engine) 
self.Session = sessionmaker(bind-self.engine) 


dal = DataAccessLayer() © 














O _init_ 提 供 了 一 种 像 工厂 一 样 使 用 指定 连接 字符 串 初始 化 连接 的 方法 。 

@ connect 方法 创建 Base 类 中 的 所 有 表 ， 它 使 用 sessionmaker 创建 会 话 ， 供 我 们 在 程序 
中 使 用 。 

e 这 行 代码 创建 了 DataAccessLayer 类 的 一 个 实例 ， 你 可 以 在 应 用 程序 中 导入 它 。 











除了 DataAccessLayer 之 外 ， 我 们 还 在 db.py 文件 中 定义 了 所 有 数据 模型 。 这 些 模型 和 我 们 
在 第 8 章 中 使 用 的 模型 是 一 样 的 ， 我 把 它们 都 放 在 了 这 里 ， 以 方便 在 应 用 程序 中 使 用 。 下 
Hie db.py 文件 中 的 所 有 模型 : 























from datetime import datetime 


from sqlalchemy import (Column, Integer, Numeric, String, DateTime, ForeignKey, 
Boolean, create engine) 
from sqlalchemy.orm import relationship, backref, sessionmaker 


class Cookie(Base): 
. tablename _ = 'cookies' 


cookie id = Column(Integer, primary key-True) 
cookie name - Column(String(50), index-True) 
cookie recipe url = Column(String(255)) 
cookie sku = Column(String(55)) 

quantity - Column(Integer()) 

unit cost - Column(Numeric(12, 2)) 


def _ repr (self): 
return "Cookie(cookie_name='{self.cookie_name}', " V 
"cookie recipe url-'([self.cookie recipe url]', " \ 
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"cookie sku='{self.cookie skuj', " \ 
"quantity={self.quantity}, " V 
"unit cost-(self.unit cost))".format(self-self) 


class User(Base): 
. tablename  - 'users' 


user id - Column(Integer(), primary key-True) 

username - Column(String(15), nullable-False, unique-True) 

email address - Column(String(255), nullable-False) 

phone = Column(String(20), nullable-False) 

password = Column(String(25), nullable-False) 

created on - Column(DateTime(), default-datetime.now) 

updated on - Column(DateTime(), default-datetime.now, onupdate-datetime.now) 


def repr (self): 
return "User(username='{self.username}', " X 
"email address-'(self.email address)', " V 
"phone='{self.phone}', " \ 
"password='{self.password}')".format(self=self) 


class Order(Base): 
__tablename__ = 'orders' 
order_id = Column(Integer(), primary_key=True) 
user id = Column(Integer(), ForeignKey('users.user id')) 
shipped = Column(Boolean(), default=False) 


user = relationship("User", backref=backref('orders', order byzorder id)) 


def repr (self): 
return "Order(user id-(self.user id), " \ 
"shipped={self.shipped})".format(self=self) 


class LineItem(Base): 
__tablename__ = 'line items' 
line item id = Column(Integer(), primary_key=True) 
order id = Column(Integer(), ForeignKey('orders.order id')) 
cookie id = Column(Integer(), ForeignKey('cookies.cookie id')) 
quantity = Column(Integer()) 
extended_cost = Column(Numeric(12, 2)) 


order = relationship("Order", backref-backref('line items', 
order by-line item id)) 
cookie - relationship("Cookie", uselist-False) 


def repr (self): 
return "LineItem(order id-(self.order id), " X 
"cookie id-(self.cookie id), " \ 
"quantity={self.quantity}, " V 
"extended cost-(self.extended cost])".format( 
self-self) 
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准备 好 数据 模型 和 访问 类 之 后 ， 接 下 来 看 看 待 测试 的 代码 。 我 们 将 为 第 7 章 中 构建 的 get_ 
orders by customer 国 数 编写 测试 ， 你 可 以 在 app.py 文件 找到 它 ， 如 示例 9-2 所 示 。 





示例 9-2 待 测 试 的 app.py 


from db import dal, Cookie, LineItem, Order, User, DataAccessLayer © 


def get orders by customer(cust name, shipped=None, details-False): 
query = dal.session.query(Order.order id, User.username, User.phone) @ 
query = query. join(User) 
if details: 
query - query.add columns(Cookie.cookie name, LineItem.quantity, 
LineItem.extended cost) 
query = query.join(LineItem).join(Cookie) 
if shipped is not None: 
query = query.filter(Order.shipped == shipped) 
results = query.filter(User.username == cust_name).all() 
return results 


O 这 是 我 们 的 DataAccessLayer 实例 (GRAF db.py XH) 和 要 在 程序 代码 中 使 用 的 数据 
模型 。 


@ 由 于 session 是 dal 对 象 的 一 个 属性 ， 所 以 我 们 需要 通过 dal 来 访问 它 。 


下 面 看 看 get_orders_by_customer 国 数 的 所 有 使 用 方法 。 在 这 个 练习 中 ， 假 设 我 们 已 经 对 
函数 的 输入 进行 了 验证 ， 它 们 的 类 型 都 是 正确 的 。 不 过 ， 在 你 的 测试 中 ， 明 智 的 做 法 是 确 
保 你 使 用 的 数据 有 能 正常 工作 的 ， 也 有 可 能 会 引起 错误 的 。 下 面 是 函数 的 参数 及 其 可 能 的 
取 值 。 

















* cust name 可 以 是 空 的 、 包 含有 效 客户 名 的 字符 串 ， 或 者 是 不 包含 有 效 客户 名 的 字符 串 。 
。 shipped 可 以 是 None, True 或 False。 
* details 可 以 是 Ture 或 False, 


如 果 想 测试 所 有 可 能 的 组 合 ， 那 么 需要 12 ( 即 3*3*2) 个 测试 来 测试 这 个 函数 。 


请 注意 ， 不 要 测试 那些 属于 SQLAlchemy 基本 功能 的 代码 ， 因 为 SQLAlchemy 
本 身 已 经 做 了 大 量 良 好 的 测试 。 比 如 ， 我 们 不 会 测试 简单 的 insert, select, 
delete 或 update 语句 ， 因 为 这 些 语 名 已 经 在 SQLAlchemy 项 目 中 测试 过 了 。 
我 们 应 该 测试 代码 操作 的 内 容 ， 这 些 内 容 可 能 会 影响 SQLAlchemy 语句 的 运 
行 方式 或 返回 的 结果 。 




















对 于 这 个 测试 示例 ， 我 们 会 使 用 内 置 的 unittest 模块 。 如 果 你 不 熟悉 这 个 模块 ， 也 不 必 
担心 ， 我 会 给 大 家 讲 讲 重点 内 容 。 首 先 ， 我 们 需要 编写 测试 类 ， 并 对 dal 的 连接 进行 初始 
化 。 为 此 ， 新 建 一 个 名 为 test_app.py 的 文件 ， 代 码 如 例 9-3 所 示 。 














示例 9-3 创建 测试 


import unittest 


from db import dal 


class TestApp(unittest.TestCase): Q 


@classmethod 

def setUpClass(cls): @ 
dal.conn string = 'sqlite:///:memory:' © 
dal.connect() 


O unittest 需要 的 测试 类 继承 自 untttest.TestCase, 
@ 测试 开始 之 前 ，setUpClass 方法 要 先 执 行 一 次 。 
e 为 测试 设置 连接 字符 串 ， 以 便 连 接 到 内 存 数据 库 。 


在 数据 库 连 接 好 之 后 ， 就 可 以 动手 编写 一 些 测试 了 。 我 们 会 把 这 些 测 试 以 函数 的 形式 添加 
到 TestApp 类 中 ， 如 示例 9-4 所 示 。 


示例 9-4 针对 空 用 户 名 的 前 6 个 测试 
def test orders by customer blank(self): © 


results = get orders by customer('') 
self.assertEqual(results, []) O 























def test orders by customer blank shipped(self): 
results - get orders by customer('', True) 
self.assertEqual(results, []) 


def test orders by customer blank notshipped(self): 
results - get orders by customer('', False) 
self.assertEqual(results, []) 


def test orders by customer blank details(self): 
results - get orders by customer('', details-True) 
self.assertEqual(results, []) 


def test orders by customer blank shipped details(self): 
results - get orders by customer('', True, True) 
self.assertEqual(results, []) 


def test orders by customer blank notshipped details(self): 
results - get orders by customer('', False, True) 
self.assertEqual(results, []) 


O unittest 要 求 每 个 测试 都 以 test 打头 。 


@ unittest 使 用 assertEqual 方法 来 验证 结果 是 否 符合 你 的 预期 。 由 于 没有 找到 用 户 ， 所 
以 你 应 该 会 得 到 一 个 空 列 表 。 
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现在 ， 把 测试 文件 保存 为 test_app.py， 然 后 使 用 如 下 命令 运行 单元 测试 : 


# python -m unittest test_app 


Ran 6 tests in 0.018s 


运行 单元 测试 时 ， 你 可 Bh e a 
略 它 就 好 ， 因 为 这 在 我 们 的 例子 中 是 正常 的 。 之 所 以 会 发 出 警 是 
SQLite 中 没有 真正 的 decimal 类 型 ， 而 SOLAlchemy 希望 你 mE, 从 SQLite 
的 float 类 型 转换 而 来 可 能 有 些 奇 怪 。 认 真 阅读 这 些 消 息 是 明智 之 举 ， 因 为 在 
生产 代码 中 ， 这 些 信息 通常 能 为 你 指出 正确 的 做 事 方法 。 这 里 我 们 特意 触发 
这 个 警告 ， 以 便 让 你 看 看 它 的 样子 。 








三 
is 
om 



































接 下 来 需要 加 载 一 些 数据 ， 并 确保 我 们 的 测试 仍然 有 效 。 同 样 ， 我 们 会 重用 第 7 章 中 的 例 
子 ， 播 入 相同 的 用 户 、 订 单 和 行 项 。 不 过 ， 这 一 次 我 们 会 把 数据 播 入 工作 放 和 一 个 名 为 
prep db 的 函数 中 ， 这 样 就 可 以 在 测试 之 前 通过 调用 prep. db 这 个 函数 来 插入 数据 了 。 为 了 
简单 起 见 ， 我 把 这 个 函数 放 入 db.py 文件 中 (参见 示例 9-5)。 但 是 ， 在 真实 情况 下 ， 我 们 
通常 会 把 它 放 到 测试 装置 或 实用 程序 文件 中 。 











示例 9-5 ”插入 一 些 测试 数据 
def prep db(session): 
c1 = Cookie(cookie name-'dark chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/dark cc.html', 
cookie sku-'CC02', 
quantity-1, 
unit cost-0.75) 


C2 = Cookie(cookie_name='peanut butter', 
cookie recipe url-'http://some.aweso.me/cookie/peanut.html', 
cookie sku-'PB01', 
quantity-24, 
unit cost-0.25) 
C3 = Cookie(cookie_name='oatmeal raisin', 


cookie recipe url-z'http://some.okay.me/cookie/raisin.html', 
cookie sku-'EWW01', 
quantity-100, 
unit cost-1.00) 
session.bulk save objects([c1, c2, c3]) 
session.commit() 


cookiemon = User(username='cookiemon', 
email_address='mon@cookie.com', 
phone='111-111-1111', 
password='password' ) 

cakeeater = User(username='cakeeater', 
email_address='cakeeater@cake.com', 
phonez'222-222-2222', 
password='password' ) 
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pieperson = User(username='pieperson', 
email_address='person@pie.com', 
phone= ' 333 -333-3333', 
password='password' ) 

session.add(cookiemon) 

session.add(cakeeater ) 

session.add(pieperson) 

session.commit() 


= Order() 
o1.user = cookiemon 
session.add(o1) 
line1 = LineItem(cookie=c1, quantity-2, extended cost-1.00) 
line2 = LineItem(cookie-c3, quantity-12, extended cost-3.00) 
o1.line items.append(linei) 
o1.line items.append(line2) 


session.commit() 


- Order() 
02.user - cakeeater 


line1 = LineItem(cookie=c1, quantity-24, extended cost-12.00) 
line2 = LineItem(cookie=c3, quantity=6, extended cost-6.00) 


02.line items.append(line1) 
02.line items.append(line2) 


session.add(o2) 
session.commit() 


到 这 里 ，prep_db 函数 就 创建 好 了 ， 现 在 可 以 在 test_app.py 文件 的 setUpClass 方法 中 调用 
它 ， 把 数据 加 载 到 数据 库 ， 再 运行 测试 。setupCtLass 方法 的 代码 如 下 : 

















@classmethod 

def setUpClass(cls): 
dal.conn string = 'sqlite:///:memory:' 
dal.connect() 
dal.session = dal.Session() 
prep. db(dal.session) 
dal.session.close() 


每 次 测试 之 前 ， 还 需要 创建 一 个 新 会 话 ， 并 在 每 次 测试 之 后 回 滚 会 话 期 间 所 做 的 所 有 
更 改 。 为 此 ， 可 以 添加 一 个 setup 方 法 ， 它 在 每 个 测试 之 前 自动 运行 ， 还 要 添加 一 个 
tearDown 方法 ， 它 在 每 个 测试 之 后 自动 运行 ， 如 下 所 示 : 





def setUp(self): @ 
dal.session - dal.Session() 


def tearDown(self): @ 
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dal.session.rollback() 
dal.session.close() 


O 每 次 测试 之 前 ， 新 建 一 个 会 话 。 
e 每 次 测试 后 ， 回 滚 测 试 期 间 所 做 的 更 改 ， 并 清除 会 话 。 
我 们 还 将 以 属性 的 形式 把 期 望 的 结果 添加 到 TestApp 类 ， 如 下 所 示 : 




















cookie orders = [(1, u'cookiemon', u'111-111-1111')] 
cookie details - [ 
(1, u'cookiemon', u'111-111-1111', 
u'dark chocolate chip', 2, Decimal('1.00')), 
(1, u'cookiemon', u'111-111-1111', 
u'oatmeal raisin', 12, Decimal('3.00'))] 


接 下 来 就 可 以 使 用 这 些 测试 数据 来 确保 我 们 的 函数 对 给 定 的 有 效用 户 名 执行 正确 的 操作 。 


把 测试 以 函数 的 形式 添加 到 TestApp 类 中 ， 如 示例 9-6 所 示 。 
示例 9-6 ”测试 有 效用 户 


def test orders by customer(self): 
results = get orders by customer('cookiemon') 
self.assertEqual(results, self.cookie orders) 


def test orders by customer shipped only(self): 
results - get orders by customer('cookiemon', True) 
self.assertEqual(results, []) 


def test orders by customer unshipped only(self): 
results - get orders by customer('cookiemon', False) 
self.assertEqual(results, self.cookie orders) 


def test orders by customer with details(self): 
results - get orders by customer('cookiemon', details-True) 
self.assertEqual(results, self.cookie details) 


def test orders by customer shipped only with details(self): 
results - get orders by customer('cookiemon', True, True) 
self.assertEqual(results, []) 


def test orders by customer unshipped only details(self): 
results - get orders by customer('cookiemon', False, True) 
self.assertEqual(results, self.cookie details) 





使 用 示例 9-6 中 的 测试 作为 指导 ， 你 能 完成 针对 不 同 用 户 (比如 cakeeater) 的 测试 吗 ? 能 





对 系统 中 不 存在 的 用 户 名 进行 测试 吗 ? 如 果 用 户 名 是 整数 而 不 是 字符 串 ， 结 果 会 怎 





样 ? 请 





将 你 的 测试 和 示例 代码 中 的 测试 进行 比较 ， 看 看 你 的 测试 是 否 与 本 书 中 使 用 的 测试 相似 。 


到 这 里 ， 我 们 已 经 学 习 了 如 何在 功能 测试 中 使 用 SQLAlchemy 来 判断 一 个 函数 在 给 定数 据 


集 上 的 行为 是 否 与 预期 一 致 。 我 们 还 了 解 了 如 何 设置 unittest 文件 ， 以 及 如 何 准 
试 中 使 用 的 数据 库 。 接 下 来 ， 我 们 在 不 访问 数据 库 的 情况 下 进行 测试 。 


mr 


























要 在 测 
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9.2 使 用 mock 


当 在 你 的 测试 环境 中 创建 测试 数据 库 没 有 意义 或 者 根本 不 可 行 时 ，mock 技术 会 派 上 大 用 
场 。 如 有 果 你 有 大 量 逻 辑 需要 对 查询 结果 进行 操作 ， 那 么 模拟 SQLAlchemy 代码 返回 你 想 要 
的 值 会 很 有 用 ， 这 样 你 就 可 以 只 测试 周边 逻辑 。 通 常 ， 在 模拟 查询 的 某 个 部 分 时 ， 我 仍然 
会 创建 内 存 数据 库 ， 但 是 我 不 会 向 其 中 加 载 任何 数据 ， 而 会 模拟 数据 库 连 接 本 身 。 这 样 我 
就 可 以 控制 执行 和 获取 方法 返回 的 内 容 。 我 们 将 在 本 市 中 学 习 如 何 做 到 这 一 点 。 


为 了 学 习 如 何在 测试 中 使 用 mock， 我 们 会 为 一 个 有 效用 户 做 一 次 测试 。 我 们 将 使 用 强大 
的 mock 库 来 控制 连接 返回 的 内 容 。 在 Python 3 中 ，mock 是 unittest 模块 的 一 部 分 。 但 
是 ， 如 果 你 使 用 的 是 Python 2， 那 么 需要 先 使 用 pip 来 安装 mock 库 ， 以 便 获 得 最 新 的 功 
能 。 为 此 ， 可 以 使 用 以 下 命令 : 












































pip install mock 


至 此 ， 我 们 已 经 安装 好 mock 库 ， 接 下 来 就 可 以 在 测试 中 使 用 它 了 。mock 有 一 个 patch() 
函数 ， 它 允许 我 们 使 用 一 个 可 以 在 测试 中 控制 的 MagicMock 替换 Python 文件 中 给 定 的 对 
$t, MagicMock 是 一 个 特殊 的 Python 对象， 它 可 以 跟踪 自身 的 使 用 方式 ， 并 允许 我 们 根据 
其 使 用 方式 来 定义 它 的 行为 。 











首先 ， 需 要 导入 mock 库 。 在 Python 2 中 ， 使 用 如 下 代码 ; 








import mock 


在 Python 3 中 ， 使 用 如 下 代码 : 





from unittest import mock 


导入 mock 库 之 后 ， 我 们 将 把 patch 方法 用 作 装 饰 器 来 奉 换 da 对 象 的 会 话 。 装 饰 器 函数 
用 来 包装 另外 一 个 函数 ， 并 可 改变 被 包装 函数 的 行为 。 因 为 da 对 象 是 通过 名 称 导 入 到 
app.py 文件 的 ， 所 以 我 们 需要 在 app 模块 中 包装 它 ， 然 后 将 其 作为 参数 传 入 测试 函数 。 现 
在 已 经 有 了 一 个 mock 对 象 ， 接 下 来 就 可 以 为 execute 方法 设置 一 个 返回 值 了 ， 本 例 中 应 
该 什么 也 不 返回 ， 但 要 接 上 fetchall 方法 ， 它 的 返回 值 是 我 们 想 要 测试 的 数据 。 示 例 9-7 
给 出 了 使 用 mock 替换 da 对 象 所 需 的 代码 。 





























示例 9-7 模拟 连接 测试 
import unittest 
from decimal import Decimal 


import mock 
from app import get orders by customer 


class TestApp(unittest.TestCase): 
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cookie orders - [(1, u'cookiemon', u'111-111-1111')] 
cookie details = [ 
(1, u'cookiemon', u'111-111-1111', 
u'dark chocolate chip', 2, Decimal('1.00')), 
(1, u'cookiemon', u'111-111-1111', 
u'oatmeal raisin', 12, Decimal('3.00'))] 


@mock.patch('app.dal.session') © 
def test_orders_by_customer(self, mock_dal): @ 
mock dal.query.return value.join.return value.filter.return value. V 
all.return value = self.cookie orders © 
results = get orders by customer('cookiemon') @ 
self.assertEqual(results, self.cookie orders) 


o 使 用 mock 替换 app 模块 中 的 dal.session, 
mock LA mock, dal 的 形式 传 入 测试 函数 。 
© 把 execute 方法 的 返回 值 设 置 成 atl 方法 的 返回 值 ， 并 将 all 方法 的 返回 值 设置 为 


self.cookie order, 


@ 调用 测试 函数 ， 模 拟 dal.connection， 并 返回 上 一 步 设 置 的 返回 值 。 


© 





你 可 以 看 到 ， 使 用 复杂 的 查询 (如 示例 9-7 所 示 ) 尝试 模拟 完整 的 查询 或 连接 时 ， 可 能 很 
快 就 会 变 得 非常 乏味 。 但 不 要 因此 而 不 这 样 做 ， 这 对 于 发 现 未 知 bug 非常 有 用 。 


我 希望 大 家 把 其 余 的 测试 作为 练习 ， 自 己 使 用 内 存 数据 库 和 模拟 测试 类 型 来 完成 它们 。 此 
外 ， 建 议 你 把 查询 和 连接 都 模拟 一 下 ， 这 样 你 会 对 整个 模拟 过 程 更 熟悉 。 











到 这 里 ， 你 应 该 已 经 熟悉 如 何 测试 包含 SOLAlchemy ORM 函数 和 模型 的 函数 。 你 还 学 会 
了 如 何 把 数据 预 填充 到 测试 数据 库 中 ， 以 便 在 测试 中 使 用 。 最 后 ， 还 学 会 了 如 何 模拟 查询 
对 象 和 连接 对 象 。 本 章 举 的 例子 比较 简单 ， 我 们 将 在 第 14 章 中 深入 学 习 测 试 ， 届 时 会 涉 
及 Flask、Pyramid 和 pytest。 














接 下 来 ， c ness 
有 数据 库 ， 这 会 用 到 反射 和 自动 映射 。 


E 
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在 第 5 章 我 们 学 过 ， 反 射 允 许 你 使 用 现 有 数据 库 填 充 SQLAlchemy 对 象 。 反 射 可 以 应 用 到 
表 、 视 图 、 索 引 和 外 键 上 。 但 是 ， 如 果 你 想 把 数据 库 模 式 反射 到 ORM 风格 的 类 中 呢 ? 幸 
运 的 是 ，SQLAlchemy 扩展 模块 中 的 automap (自动 映射 ) 允许 你 这 样 做 。 

















基于 automap 的 反射 是 一 个 非常 有 用 的 工具 。 然 而 ， 在 SQLAlchemy 1.0 版 本 中 ， 我 们 不 
能 反射 CheckConstraints、 注 释 和 触发 器 。 你 也 不 能 反射 客户 端的 默认 值 ， 以 及 序列 与 列 
之 间 的 关联 。 但 是 ,我们 可 以 使 用 第 6 章 讲 的 方法 手动 添加 它们 。 


如 同 第 5 章 ， 我 们 使 用 Chinook 数据 库 做 测试 。 这 里 ， 我 们 用 的 是 Chinook 数据 库 的 
SQLite 版 本 ， 你 可 以 在 本 书 示例 代码 的 CH10 文件 夹 中 找到 它 。 这 个 文件 夹 中 还 包含 一 张 
数据 库 模式 图 像 ， 通 过 它 你 可 以 清晰 地 了 解 本 章 中 使 用 的 模式 。 


10.1 使 用 自动 映射 反射 数据 库 


为 了 反射 数据 库 ， 我 们 会 使 用 automap_base， 而 不 是 之 前 一 直 使 用 的 ORM declarative_ 
base。 先 创建 一 个 Base 对 象 ， 如 示例 10-1 所 示 。 























示例 10-1 使 用 automap_base 创建 Base 对 象 


from sqlalchemy.ext.automap import automap base @ 


Base = automap base() @ 
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@ 从 automap 扩展 导入 automap base, 
@ 初始 化 Base 对 象 。 


接 下 来 需要 将 一 个 引擎 连接 到 想 反 射 的 数据 库 。 示 例 10-2 演示 了 如 何 连 接 到 Chinook 数 


示例 10-2 为 Chinook 数据 库 初 始 化 引擎 


from sqLaLchemy import create engine 








engine = create engine('sqlite:///Chinook Sqlite.sqlite') © 


9 连接 字符 串 假 设 当前 文件 和 示例 数据 库 在 同一 目录 下 。 








当 Base 和 引擎 创建 好 之 后 ， 我 们 就 做 好 了 反射 数据 库 的 准备 工作 。 调 用 示例 10-1 中 创建 
的 Base 对 象 的 prepare 方法 ， 将 扫描 我 们 刚刚 创建 的 引擎 上 的 所 有 可 用 内 容 ， 并 反射 它 所 
能 反射 的 所 有 内 容 。 下 面 是 使 用 Base 对 象 反 射 数据 库 的 代码 : 

















Base.prepare(engine, reflect-True) 
只 需要 这 一 行 代 码 ， 就 完成 了 整个 数据 库 的 映射 工作 。 这 个 反射 已 经 为 每 个 表 创 建 了 


ORM 对 象 。 可 以 在 Base 的 class 属性 下 访问 这 些 表 。 要 打印 出 这 些 对 象 ， 只 需 运 行 如 下 
代码 : 








Base.classes.keys() 

















执行 代码 ， 会 得 到 如 下 结果 : 


['Album', 
'Customer', 
'Playlist', 
'Artist', 
'Track', 
'Employee', 
'MediaType', 
'Invoiceline', 
'Invoice', 
'Genre'] 





接 下 来 创建 两 个 引用 Artist 和 Album 表 的 对 象 : 


Artist = Base.classes.Artist 
Album - Base.classes.Album 


第 一 行 代码 创建 了 一 个 到 Artist ORM 对 象 的 引用 ， 第 二 行 代码 创建 了 一 个 到 Album 


ORM 对 象 的 引用 。 可 以 像 使 用 第 7 章 手 动 定义 的 ORM 对 象 一 样 使 用 Artist 对 象 。 示 例 
10-3 演示 了 如 何 使 用 对 象 执 行 简单 的 查询 ， 以 获取 表 中 的 前 10 条 记录 。 
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示例 10-3 ”使 用 Artist 表 
from sqlalchemy.orm import Session 
session - Session(engine) 


for artist in session.query(Artist).limit(10): 
print(artist.ArtistId, artist.Name) 


运行 示例 10-3， 会 得 到 如 下 结果 : 


(1, u'AC/DC') 

(2, u'Accept') 

(3, u'Aerosmith') 

(4, u'Alanis Morissette') 

(5, u'Alice In Chains') 

(6, u'Ant\xf4nio Carlos Jobim') 
(7, u'Apocalyptica') 

(8, u'Audioslave') 

(9, u'BackBeat') 


(10, u'Billy Cobham') 


HE, 我们 已 经 学 会 如 何 反 射 数据 库 ， 以 及 如 何 将 其 映射 到 对 象 。 接 下 来 学 习 使 用 自动 映 
射 反射 关系 的 方法 。 


10.2 反射 关系 


自动 映射 可 以 自动 反射 和 建立 多 对 一 、 一 对 多 和 多 对 多 的 关系 。 接 下 来 看 看 ALbum 和 
Artist 表 之 间 的 关系 是 如 何 建立 的 。 当 automap 创建 一 个 关系 时 ， 它 会 在 对 象 上 创建 一 个 
«related object» collection 属性 ， 请 看 示例 10-4 中 的 Artist HK, 























示例 10-4 使 用 Artist Fi Album 之 间 的 关系 打印 相关 数据 
artist = session.query(Artist).first() 
for album in artist.album collection: 
print('{} - {}'.format(artist.Name, album.Title)) 




















运行 上 面 的 代码 ， 会 得 到 如 下 结果 : 











AC/DC - For Those About To Rock We Salute You 
AC/DC - Let There Be Rock 


你 还 可 以 配置 自动 映射 ， 并 修改 它 的 某 些 行为 ， 这 样 可 以 让 创建 的 类 更 符合 特定 要 求 。 不 过 ， 
这 些 内 容 远 远 超 出 了 本 书 的 讨论 范围 。 你 可 以 在 SQLAlchemy 文档 中 了 解 更 多 这 方面 的 内 容 。 





























本 章 讲 解 了 SQLAlchemy ORM 的 重要 内 容 。 希 望 你 通过 本 章 的 学 习 ， 认 识 到 了 SQLAlchemy 
的 反射 功能 是 多 么 地 强大 。 本 书 为 你 学 习 ORM 打下 了 坚实 的 基础 ， 但 要 学 的 内 容 还 有 很 
多 。 要 想 获取 更 多 内 容 ， 请 参阅 SQLAlchemy 文档 。 























在 下 一 部 分 ， 我 们 将 学 习 如 何 使 用 Alembic 来 管理 数据 库 迁 移 ， 以 便 在 不 破坏 和 重新 创建 
数据 库 的 情况 下 更 改 数据 库 模式 。 
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第 三 部 分 
Alembic 























Alembic 是 一 个 处 理 数据 库 更 改 的 工具 ， 它 利用 SQLAlchemy 来 执行 迁移 。 当 我 们 使 用 元 
数据 的 create all 方法 时 ，SQLAlchemy 只 会 创建 缺失 的 表 ， 所 以 它 不 会 更 新 数据 库 表 以 
反映 我 们 对 列 所 做 的 更 改 ， 而 且 它 也 不 会 删除 我 们 已 经 在 代码 中 删除 的 表 。Alembic 提供 
了 一 种 添加 /删除 表 、 更 改 列 名 和 添加 新 约束 的 方法 。 由 于 Alembic 使 用 SOLAlchemy 做 
迁移 ， 所 以 可 以 在 大 量 后 端 数 据 库 上 使 用 。 
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Alembic 提供 了 一 种 创建 和 执行 迁移 的 程序 化 方法 ， 让 我 们 可 以 随 着 程序 的 演进 灵活 地 处 
理 需 要 对 数据 库 做 的 更 改 。 例 如 ， 我 们 可 以 向 表 中 添加 列 ， 或 者 从 模型 中 删除 属性 ， 还 
可 以 添加 全 新 的 模型 ， 或 者 把 现 有 模型 分 解 为 多 个 模型 。Alembic 为 我 们 提供 了 一 种 利用 
SQLAlchemy 的 强大 功能 来 做 这 些 更 改 的 方法 。 


开始 之 前 ， 需 要 先 安 装 Alembic。 可 以 使 用 如 下 代码 安装 Alembic: 


























pip install alembic 


安装 好 Alembic 之 后 ， 还 需要 创建 迁移 环境 。 


11.1 创建 迁移 环境 


为 了 创建 迁移 环境 ， 首 先 创建 一 个 名 为 CHI11 的 文件 夹 ， 并 进入 这 个 目录 。 而 后 ， 运 
fy alembic init alembic 命令 在 alembic/ 目录 中 创建 迁移 环境 。 人们 通常 会 选择 在 
migrations/ 目录 中 创建 迁移 环境 ， 为 此 可 以 使 用 alembic init migrations 命令 。 你 也 可 以 
随意 为 目录 起 一 个 自己 喜欢 的 名 字 ， 但 我 建议 你 起 一 个 与 众 不 同 的 名 字 ， 并 且 一 定 不 要 和 
某 个 模块 的 名 字 重 复 。 这 个 初始 化 过 程 会 创建 迁移 环境 并 创建 一 个 alembic.ini 文件 ， 这 个 
文件 里 面包 含 配 置 选 项 。 现 在 ， 查 看 我 们 的 目录 ， 会 看 到 以 下 结构 : 














|— alembic 
| L— README 

| FF env. py 

| b script.py.mako 
| [一 versions 

L— alembic.ini 
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在 新 创建 的 迁移 环境 中 ， 我 们 会 看 到 一 个 envpy 文件 、 一 个 script.py.mako 模板 文件 ， 以 
及 一 个 versions/ 目录 。 其 中 ，versions/ 目录 用 来 保存 迁移 脚本 。Alembic 会 使 用 env.py X 
件 定义 和 实例 化 SQLAlchemy 引擎 ， 然 后 连接 到 这 个 引擎 ， 局 动 一 个 事务 ， 并 且 当 你 运行 
Alembic 命令 时 ， 它 会 正确 地 调用 迁移 引擎 。scriptpymako 模板 用 来 创建 迁移 ， 它 定义 了 
迁移 的 基本 结构 。 


创建 好 迁移 环境 之 后 ， 要 对 它 进行 配置 ， 以 使 其 和 我 们 的 应 用 程序 协同 工作 。 


11.2 配置 迁移 环境 


首先 调整 alembic.ini 和 env.py 文件 中 的 设置 ， 这 样 Alembic 才能 与 我 们 的 数据 库 和 应 用 程 
序 一 起 工作 。 让 我 们 从 alembic.ini 文件 开始 ， 更 改 其 中 的 sqlalchemy.url 配置 项 ， 将 其 修 
改 为 我 们 的 数据 库 连 接 字 符 串 。 这 里 ， 我 们 想 让 它 连 接 到 当前 目录 下 一 个 名 为 alembictest. 
db 的 SQLite 文件 。 为 此 ， 修 改 sqlalchemy.url 行 ， 如 下 所 示 : 


























sqlalchemy.url = sqlite:///alembictest.db 


在 所 有 Alembic 示例 中 ， 我 们 会 使 用 ORM 的 声明 式 风格 在 app/db.py 文件 中 创建 所 有 代 
码 。 首 先 ， 创建 一 个 app/ 目录 ， 并 在 其 中 创建 一 个 空 的 _init .py 文件， 让 app 成 为 一 个 
模块 。 


然后 ， 在 app/db.py 中 添加 如 下 代码 ， 对 SOLAlchemy 进行 设置 ， 使 其 使 用 的 数据 库 和 
alembic.ini 文件 中 (对 Alembic) 配置 的 一 样 ， 并 且 定 义 一 个 基 类 。 



































from sqlalchemy import create engine 
from sqlalchemy.ext.declarative import declarative base 
from sqlalchemy.orm import sessionmaker 


engine = create engine('sqlite:///alembictest.db') 

Base - declarative base() 
接 下 来 更 改 envpy 文件 ， 让 其 指向 我 们 的 metadata, metadata 是 我 们 在 app/db.py 中 创建 
的 Base 实例 的 一 个 属性 。env.py 会 使 用 metadata 将 在 数据 库 中 找到 的 数据 与 SQLAlchemy 
中 定义 的 模型 进行 比较 。 首 先 ， 要 把 当前 目录 添加 到 Python 用 来 定位 模块 的 路 径 中 ， 这 样 
它 就 可 以 找到 我 们 的 app 模块 了 : 














import os 
import sys 


sys.path.append(os.getcwd()) @ 


O 将 当前 工作 目录 (CHII) 添加 到 sys.path 中 ，Python 会 在 sys.path 中 搜索 模块 。 
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最 后 ， 修 改 env.py 文件 中 的 target metadata 一 行 ， 将 其 改 为 app/db.py 文件 中 的 metadata 
对 象 ， 如 下 所 示 : 


from app.db import Base @ 
target metadata = Base.metadata @ 


@ 导入 Base 实例 。 
@ ik Alembic 把 Base.metadata 作为 目标 。 





完成 这 一 步 之 后 ， 我 们 就 设置 好 Alembic 环境 了 ， 此 时 它 可 以 使 用 应 用 程序 的 数据 库 和 元 
数据 。 我 们 还 构建 好 了 一 个 应 用 程序 框架 ， 我 们 会 在 其 中 定义 数据 模型 ， 相 关内 容 在 第 12 
FA UES. 
本 章 中 ， 我 们 学 习 了 如 何 创建 迁移 环境 ， 以 及 如 何 配置 它 ， 以 使 其 共享 应 用 程序 的 数据 库 
和 元 数据 。 在 下 一 章 中 ， 我 们 会 学 习 创 建 迁 移 的 两 种 方式 : 一 种 是 手动 方式 ， 另 一 种 是 使 
用 自动 生成 功能 。 
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在 第 11 章 中 ， 我 们 初始 化 并 配置 好 了 Alembic 迁移 环境 。 接 下 来 就 可 以 向 应 用 程序 添加 数 
据 类 ， 以 及 创建 迁移 并 把 它们 添加 到 数据 库 中 了 。 本 章 ， 我 们 会 学 习 如 何 使 用 自动 生成 方 
式 添加 表 ， 以 及 如 何 用 手动 迁移 来 完成 自动 生成 方式 无 法 做 到 的 事情 。 让 我 们 从 一 个 空 迁 
移 开始 做 起 ， 空 迁移 可 以 为 我 们 的 迁移 提供 一 个 干净 的 起 点 。 


12.1 创建 基础 空 迁移 


为 了 创建 基础 空 迁 移 ， 首 先 要 确保 你 当前 在 CH12 文件 夹 下 ， 而 后 使 用 如 下 命令 创建 空 迁移 : 


























# alembic revision -m "Empty Init" © 
Generating chi2/alembic/versions/8a8a9d067 empty init.py ... done 


© 运行 alembic revision 命令 ， 并 向 迁移 添加 信息 (-m) "Empty Init", 


这 会 在 alembic/versions/ 子 文件 夹 下 创建 一 个 迁移 文件 。 文 件 名 总 是 以 代表 修订 ID W 
开头 ， 然 后 是 你 提供 的 信息 。 下 面 看 看 文件 内 部 : 

'"" Empty Init 09 

Revision ID: 8a8a9d067 


Revises: 
Create Date: 2015-09-13 20:10:05.486995 


# revision identifiers, used by Alembic. 
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revision = '8a8a9d067' @ 
down revision = None © 
branch labels = None @ 
depends on = None © 


from alembic import op 


import sqlalchemy as sa 


def upgrade(): 
pass 


def downgrade(): 
pass 


@ 我 们 指定 的 迁移 信息 。 

@ 修订 ID. 

@ 用 来 确定 如 何 降级 的 前 一 次 修订 。 
o 

© 











和 这 次 迁移 相关 的 分 支 。 
本 次 迁移 依赖 的 迁移 。 
文件 头 部 分 包含 我 们 提供 的 信息 〈 如 果 有 的 话 )、 修 订 ID 以 及 创建 日 期 和 时 间 。 接 下 来 是 标 
识 符 部 分 ， 它 指出 迁移 的 性 质 ， 以 及 降级 或 依赖 的 细节 ， 或 者 和 本 次 迁移 相关 的 分 支 。 一 般 
来 说 ， 如 果 你 在 代码 的 一 个 分 支 中 修改 数据 类 ， 那 你 可 能 还 需要 为 Alembic 迁移 建立 分 支 。 





























接 下 来 是 upgrade 方法 ， 里 面包 含 执行 迁移 时 用 于 改动 数据 库 的 所 有 Python 代码 。 最 后 是 
downgrade 方法 ， 里 面 的 代码 用 来 撤销 本 次 迁移 ， 并 把 数据 库 恢复 到 先前 的 迁移 步骤 。 


由 于 目前 没有 任何 数据 类 ， 也 没有 做 任何 更 改 ， 所 以 upgrade 和 downgrade 方法 都 是 空 的 。 
因此 ， 运 行 这 个 迁移 不 会 产生 任何 影响 ， 但 它 为 我 们 的 迁移 链 提供 了 一 个 很 好 的 基础 。 为 
了 完成 从 当前 数据 库 状 态 到 最 高 Alembic 迁移 的 所 有 迁移 ， 要 执行 以 下 命令 : 








# alembic upgrade head © 

INFO [alembic.runtime.migration] Context impl SQLiteImpl. 

INFO [alembic.runtime.migration] Will assume non-transactional DDL. 

INFO [alembic.runtime.migration] Running upgrade -» 8a8a9d067, Empty Init 


@ 将 数据 库 升 级 到 最 新 版 本 。 


前 面 的 输出 会 把 数据 库 最 新 修订 以 前 的 每 次 修订 都 列 出 来 。 在 本 例 中 ， 只 有 一 个 “Empty 
Initf ”迁移 ， 它 最 后 和 运行。 



































在 此 基础 之 上 ， 就 可 以 把 用 户 数 据 类 添加 到 应 用 程序 了 。 添 加 好 数据 类 之 后 ， 就 可 以 创建 
一 个 自动 生成 的 迁移 ， 并 使 用 它 在 数据 库 中 创建 关联 表 。 














12.2 ”自动 生成 迁移 


接 下 来 ， 让 我 们 把 用 户 数据 类 添加 到 app/db.py 中 。 这 里 添加 的 是 Cookie 类， 它 和 前 面 讲 
ORM 时 使 用 的 类 是 一 样 的 。 首 先 从 sqlalchemy 导入 编写 Cookie 类 时 要 使 用 的 Column 和 
列 类 型 ， 然 后 再 添加 Cookie 类 ， 如 示例 12-1 所 示 。 



































示例 12-1 修改 app/db.py 


from sqlalchemy import create engine, Column, Integer, Numeric, String 


from sqlalchemy.ext.declarative import declarative base 
from sqlalchemy.orm import sessionmaker 


engine - create engine('sqlite:///alembictest.db') 


Base - declarative base() 


class Cookie(Base): 
. tablename  - 'cookies' 


cookie id = Column(Integer, primary key-True) 
cookie name - Column(String(50), index-True) 
cookie recipe url = Column(String(255)) 
cookie sku = Column(String(55)) 

quantity - Column(Integer()) 

unit cost - Column(Numeric(12, 2)) 


添加 好 Cookie 类 之 后 ， 接 下 来 创建 迁移 ， 把 这 个 表 添加 到 数据 库 。 这 个 迁移 非常 简单 ， 可 
以 使 用 Alembic 自动 生成 它 〈 见 示例 12-2)。 


示例 12-2 ”自动 生成 迁移 


# alembic revision --autogenerate -m "Added Cookie model" © 
INFO [alembic.runtime.migration] Context impl SQLiteImpl. 
INFO [alembic.runtime.migration] Will assume non-transactional DDL. 
INFO [alembic.autogenerate.compare] Detected added table 'cookies' 
INFO [alembic.autogenerate.compare] Detected added index 'ix cookies cookie name' 
n '['cookie name']' 
Generating chi2/alembic/versions/34044511331 added cookie model.py ... done 





E 











O 使 用 “Added Cookie model” 这 个 信息 自动 生成 一 个 迁移 。 





因此 ， 当 运行 自动 生成 命令 时 ，Alembic 首先 会 检查 SOLAlchemyBase 的 元 数据 ， 而 后 将 
其 与 当前 数据 库 状 态 进行 比较 。 在 示例 12-2 中 ， 它 检测 到 我 们 添加 了 一 个 名 为 cookies 
的 表 ee 和 该 表 cookie name 字段 上 的 索引 。 它 把 这 些 差异 标记 为 
更 改 ， 并 添加 丈 辑 以 便 在 迁移 文件 中 创建 它们 。 下 面 看 一 下 它 创 建 的 迁移 文件 ， 如 示例 
12-3 所 示 。 























示例 12-3 cookies 迁移 文件 
"""Added Cookie model 


Revision ID: 34044511331 
Revises: 8a8a9d067 
Create Date: 2015-09-14 20:37:25.924031 


* revision identifiers, used by Alembic. 
revision - '34044511331' 

down revision = '8a8a9d067' 

branch labels - None 

depends on = None 


from alembic import op 
import sqlalchemy as sa 


def upgrade(): 
### commands auto generated by Alembic - please adjust! ### 
op.create table('cookies', @ 
sa.Column('cookie id', sa.Integer(), nullable-False), 
sa.Column('cookie name', sa.String(length-50), nullable-True), 
sa.Column('cookie recipe url', sa.String(length=255), nullable-True), 
sa.Column('cookie sku', sa.String(length=55), nullable=True), 
sa.Column('quantity', sa.Integer(), nullable-True), 
sa.Column('unit cost', sa.Numeric(precision-12, scale-2), nullable-True), 
sa.PrimaryKeyConstraint('cookie id') @ 
) 
op.create index(op.f('ix cookies cookie name'), 'cookies', ['cookie name'], 

unique-False) © 

### end Alembic commands ### 


def downgrade(): 

### commands auto generated by Alembic - please adjust! ### 

op.drop index(op.f('ix cookies cookie name'), table_name='cookies') @ 
op.drop table('cookies') © 

### end Alembic commands ### 


@ [EH Alembic 的 create table 方法 添加 cookies 表 。 

@ 在 cookie_id 列 上 添加 主键 。 

© 使 用 Alembic 的 create_index 方法 ， 在 cookie name 列 上 添加 索引 。 

O 使 用 Alembic 的 drop. index 方法 删除 cookie name 索引 。 

日 删除 cookies 表 。 

在 示例 12-3 的 upgrade 方法 中 ，create_table 方法 的 语法 与 第 1 章 讲 SQLAlchemy Core 时 


使 用 的 Table 构造 国 数 是 一 样 的 : 先是 表 名 ， 而 后 是 表 的 列 和 约束 。create_index 方 法 也 
和 第 1 章 中 使 用 的 Index 构造 函数 一 样 。 











最 后 ， 示 例 12-3 中 的 downgrade 方法 按 正 确 的 顺序 使 用 了 Alembic 的 drop. index 和 drop_ 
table 方法 ， 确 保 索 引 和 表 都 删除 了 。 











参考 前 面 运行 空白 迁移 的 命令 ， 运 行 这 个 迁移 ， 如 下 : 





# alembic upgrade head 
INFO [alembic.runtime.migration] Context impl SQLiteImpl. 
INFO [alembic.runtime.migration] Will assume non-transactional DDL. 


INFO [alembic.runtime.migration] Running upgrade 8a8a9d067 -» 34044511331, 
Added Cookie model 


运行 之 后 ， 查 看 一 下 数据 库 ， 看 看 更 改 是 否 生 效 了 : 





# sqlite3 alembictest.db @ 

SQLite version 3.8.5 2014-08-15 22:37:57 

Enter ".help" for usage hints. 

sqlite> .tables @ 

alembic_version cookies 

sqlite> .schema cookies © 

CREATE TABLE cookies ( 
cookie_id INTEGER NOT NULL, 
cookie name VARCHAR(50), 
cookie recipe url VARCHAR(255), 
cookie sku VARCHAR(55), 
quantity INTEGER, 
unit cost NUMERIC(12, 2), 
PRIMARY KEY (cookie id) 


CREATE INDEX ix cookies cookie name ON cookies (cookie name); 


@ 使 用 sqlite3 命令 访问 数据 库 。 
e 列 出 数据 库 中 的 表 。 
© 打印 cookies 表 的 结构 。 








KET! 我 们 的 迁移 完美 地 创建 出 了 表 和 索引 。 不 过 ，Alembic 的 自动 生成 功能 本 身 有 一 
些 局 限 性 。 表 12-1 列 出 了 自动 生成 功能 可 以 检测 到 的 一 些 常见 模式 变化 ， 而 表 12-2 则 列 
出 了 自动 生成 功能 不 能 检测 到 或 检测 不 准 的 一 些 模式 变化 。 








表 12-1: 自动 生成 功能 可 以 检测 到 的 模式 变化 
模式 元 素 = 改 






























































表 添加 和 删除 

列 添加 、 删 除 、 列 的 “允许 空 值 ”状态 的 变化 

索引 索引 的 基本 变化 、 显 式 命名 的 唯一 性 约束 、 支 持 自动 生成 索引 和 唯一 性 约束 
键 基本 的 重 命名 
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12-2: 自动 生成 功能 无 法 检测 到 的 模式 变化 








模式 元 素 更 改 
表 名 称 变化 
列 名 称 变化 
约束 无 明确 名 称 的 约束 


除了 自动 生成 功能 支持 和 不 能 支持 的 功能 之 外 ， 还 有 一 些 可 选 功能 需要 做 特殊 的 配置 或 定 
制 代码 才能 实现 。 例 如 ， 对 列 类 型 的 更 改 或 对 服务 器 默认 值 的 更 改 。 如 果 想 了 解 更 多 有 关 
自动 生成 的 功能 和 局 限 性 的 内 容 ， 可 以 阅读 Alembic autogenerate 文档 。 


12.3 手动 创建 迁移 


Alembic 不 能 检测 表 名 的 变化 ， 所 以 下 面 了 解 一 下 如 何在 不 使 用 自动 生成 功能 的 情况 下 检 
测 到 表 名 的 变化 ， 并 将 cookies 表 更 改 为 new_cookies 表 。 我 们 需要 先 更 改 app/db.py 的 
Cookie 类 中 的 __tablename__, 40 Atm: 
































class Cookie(Base): 
__tablename__ = 'new cookies' 


接 下 来 需要 新 建 一 个 迁移 ， 我 们 可 以 使 用 “Renaming cookies to new_cookies” 编 辑 它 : 


# alembic revision -m "Renaming cookies to new cookies" 
Generating chi2/alembic/versions/2e6a6cc63e9 renaming cookies to new cookies.py 
. done 


迁移 建 好 之 后 ， 还 要 编辑 迁移 文件 ， 并 向 upgrade 和 downgrade 方法 添加 重 命名 操作 ， 如 
下 所 示 : 








def upgrade(): 
op.rename table('cookies', 'new cookies') 


def downgrade(): 
op.rename table('new cookies', 'cookies') 


接 下 来 ， 使 用 alembicupgrade 命令 运行 迁移 : 


# alembic upgrade head 

INFO [alembic.runtime.migration] Context impl SQLiteImpl. 

INFO [alembic.runtime.migration] Will assume non-transactional DDL. 

INFO [alembic.runtime.migration] Running upgrade 34044511331 -» 2e6a6cc63e9, 
Renaming cookies to new cookies 


这 会 把 数据 库 中 的 表 重 命名 为 new_cookies。 然 后 ， 使 用 salite 命令 ， 查 看 一 下 更 改 是 否 
生效 : 





+ sqlite3 alembictest.db 

SQLite version 3.8.5 2014-08-15 22:37:57 
Enter ".help" for usage hints. 

sqlite> .tables 

alembic_version new_cookies 


和 我 们 想 的 一 样 ，cookies 表 不 复 存 在 ， 因 为 它 已 经 被 new_cookie RAK, ER f rename_ 
table 之 外 ，Alembic 中 还 有 许多 操作 可 以 帮助 你 更 改 数据 库 ， 如 表 12-3 所 示 。 


表 12-3: Alembic 操 作 



































ke E 用 B 

add column 添加 新 列 
alter_column 更 改 列 类 型 、 服 务 器 默认 值 或 名 称 
create check constraint 添加 新 的 检查 约束 
create foreign key 添加 新 的 外 键 
create_index 添加 新 索引 

create primary key 添加 新 主 
create_table 添加 新 表 

create unique constraint 添加 新 的 唯一 性 约束 
drop. column I 除 列 
drop_constraint IER 

drop index | 除 索 引 

drop_table IRK 

execute 运行 原始 SQL 语句 
rename table EMAK 











虽然 Alembic 支持 表 12-3 中 的 所 有 操作 ， 但 并 不 是 每 个 后 端 数据 库 都 支持 它 
们 。 比 如 ，atLter_cotLumn 无 法 在 SQLite 数据 库 上 工作 ， 因 为 SQLite 不 支持 
以 任何 方式 修改 列 。SQLite 也 不 支持 删除 列 。 








在 本 章 中 ， 我 们 学 习 了 实现 自动 迁移 和 手动 迁移 的 方法 ， 以 便 以 一 种 可 重复 的 方式 对 数据 
库 进 行 更 改 。 我 们 还 学 习 了 如 何 使 用 alembic upgrade 命令 让 迁移 生效 。 请 记 住 ， 除 了 使 
用 Alembic 操作 之 外 ， 还 可 以 在 迁移 中 使 用 Python 代码 来 帮助 我 们 实现 目标 。 在 下 一 章 
中 ， 我 们 将 学 习 如 何 进 行 降级 和 进一步 控制 Alembic. 
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控制 Alembic 











在 上 一 章 中 ， 我 们 学 习 了 如 何 创建 和 应 用 迁移 ， 这 一 章 将 讨论 如 何 进 一 步 控制 Alembic. 
我 们 将 探索 如 何 了 解数 据 库 的 当前 迁移 级 别 ， 如 何 从 迁移 降级 ， 以 及 如 何在 某 个 迁移 级 别 
上 标记 数据 库 。 


ok * 口 
13.1 确定 数据 库 的 迁移 级 别 
做 迁移 之 前 ， 你 应 该 仔细 检查 一 下 ， 弄 清 哪些 迁移 已 经 应 用 到 数据 库 中 。 借 助 alembic 
current 命令 ， 你 可 以 知道 应 用 到 数据 库 的 最 后 一 次 迁移 是 什么 。 这 个 命令 会 返回 当前 迁 
移 的 修订 ID ， 并 告诉 你 它 是 否 是 最 后 一 次 迁移 (也 称 为 head)。 让 我 们 在 本 书 示例 代码 的 
CH12/ 文件 夹 中 运行 alembic current MS: 


























# alembic current 

INFO [alembic.runtime.migration] Context impl SQLiteImpl. 

INFO [alembic.runtime.migration] Will assume non-transactional DDL. 
2e6a6cc63e9 (head) @ 


@ 最 后 一 次 应 用 到 数据 库 的 迁移 。 


一 方面 ， 输 出 指出 当前 的 迁移 是 2e6a6cc63e9。 另 一 方面 ， 它 也 告诉 我 们 这 是 最 后 一 次 
迁移 。 正 是 在 这 次 迁移 中 ， 我 们 把 cookies 表 改 成 了 new_cookies。 另 外 ， 还 可 以 使 用 
alembic history 命令 对 此 进行 确认 ， 这 个 命令 会 显示 一 个 迁移 列表 ， 如 示例 13-1 所 示 。 
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示例 13-1 迁移 历史 


# alembic history 

34044511331 -> 2e6a6cc63e9 (head), Renaming cookies to new cookies 
8a8a9d067 -» 34044511331, Added Cookie model 

«base» -» 8a8a9d067, Empty Init 


示例 13-1 的 输出 显示 了 从 最 开始 的 空 迁 移 到 当前 迁移 (命名 cookies R) 的 每 个 步 又。 对 
于 new cookies 这 个 表 名 ， 我 想 大 家 的 想法 一 样 ， 那 就 是 它 是 一 个 精 糕 的 名 字 ， 尤 其 是 当 
我 们 再 次 更 改 cookies 并 使 用 new_new_cookies 这 个 名 字 时 。 为 了 修正 这 个 问题 ， 将 其 恢 
复 到 以 前 的 名 字 ， 我 们 要 进行 迁移 降级 。 下 面 一 起 学 习 一 下 迁移 降级 。 


13.2 ”迁移 降级 


要 做 迁移 降级 ， 需 要 选择 想 返 回 的 那 次 迁移 的 修订 ID。 比 如 ， 如 果 你 想 返 回 到 最 初 的 空 
迁移 ， 你 应 该 选择 的 修订 ID 是 8a8a9d067。 这 里 ， 我 们 主要 想 撤销 表 的 重 命名 。 下 面 使 用 
alembic downgrade 命令 恢复 到 修订 ID A) 34044511331 的 状态 。 















































示例 13-2 迁移 降级 


# alembic downgrade 34044511331 

INFO [alembic.runtime.migration] Context impl SQLiteImpl. 

INFO [alembic.runtime.migration] Will assume non-transactional DDL. 

INFO [alembic.runtime.migration] Running downgrade 2e6a6cc63e9 -» 34044511331, 
Renaming cookies to new cookies @ 





@ 降级 行 。 








从 示例 13-2 输出 中 的 降级 一 行 可 以 看 出 ， 表 名 恢复 了 。 我 们 在 第 12 章 中 学 过 .tables fy 
令 ， 这 里 我 们 使 用 它 查 看 表 。 你 会 看 到 如 下 输出 : 











# sqlite3 alembictest.db 

SQLite version 3.8.5 2014-08-15 22:37:57 
Enter ".help" for usage hints. 

sqlite> .tables 

alembic version cookies @ 


0 XE cookies, 























从 上 面 输出 的 结果 可 以 看 到 ， 表 名 已 经 恢复 为 原来 的 名 字 (cookies), PHEN alembic 
current 命令 查看 数据 库 所 处 的 迁移 级 别 : 








+ alembic current 

INFO  [alembic.runtime.migration] Context impl SQLiteImpl. 

INFO  [alembic.runtime.migration] Will assume non-transactional DDL. 
34044511331 © 


@ 添加 cookies 模型 迁移 的 修订 ID, 





可 以 看 到 ， 我 们 回 到 了 downgrade 命令 中 指定 的 迁移 。 如 果 想 把 应 用 程序 恢复 到 工作 状态 ， 
还 需要 更 新 应 用 程序 代码 ， 以 便 使 用 cookies 表 名 ， 就 像 我 们 在 第 12 章 中 所 做 的 那样 。 你 
可 能 还 会 发 现 ， 我 们 不 在 最 新 的 迁移 中 ， 因 为 head 不 在 最 后 一 行 。 这 个 问题 需要 处 理 一 
下 。 如 果 不 想 再 把 重 命名 的 cookies 用 于 new cookies 迁移 ， 只 需 将 其 从 alembic/versions/ 
目录 中 删除 。 如 果 你 置之不理 ， 那 么 当下 一 次 运行 alembic upgrade head 时 ， 它 就 会 运 
行 ， 这 可 能 会 导致 灾难 性 的 后 果 。 这 里 ， 我 们 留 着 它 ， 是 为 了 方便 学 习 如 何 为 数据 库 标 记 
迁移 级 别 。 


13.3 ”标记 数据 库 迁 移 级 别 
当 我 们 要 执行 诸如 跳 过 迁移 或 恢复 数据 库 之 类 的 操作 时 ， 数 据 库 可 能 会 认为 我 们 的 迁移 和 


实际 情况 不 同 。 为 了 纠正 这 个 问题 ， 需 要 明确 地 把 数据 库 标 记 成 某 个 特定 的 迁移 级 别 。 在 
示例 13-3 中 ， 我 们 将 使 用 alembic stamp 命令 把 数据 库 标 记 为 修订 ID2e6a6cc63e9。 



































示例 13-3 ”标记 数据 库 迁 移 级 别 
# alembic stamp 2e6a6cc63e9 
INFO [alembic.runtime.migration] Context impl SQLiteImpl. 
INFO [alembic.runtime.migration] Will assume non-transactional DDL. 
INFO [alembic.runtime.migration] Running stamp revision 34044511331 
-» 2e6a6cc63e9 





从 示例 13-3 可 以 看 到 ，alembic stamp a7 4-46 “revision 34044511331” 标 记 为 当前 数据 库 
的 迁移 级 别 。 但 是 ， 如 果 我 们 查看 数据 库 表 ， 仍 然 会 看 到 cookies 表 。 标 记 数 据 库 迁 移 级 
别 并 不 会 实际 运行 迁移 ， 它 只 是 更 新 Alembic 表 ， 以 此 反映 我 们 在 命令 中 提供 的 迁移 级 
别 。 这 实际 上 跳 过 了 34044511331 迁移 。 








如 果 你 像 这 样 跳 过 某 个 迁移 ， 那 么 它 只 适用 于 当前 数据 库 。 如 果 你 更 改 
sqlalchemy.url, ik Alembic 迁移 环境 指向 另 一 个 数据 库 ， 而 新 数据 库 又 低 
于 跳 过 的 迁移 的 级 别 或 者 为 空 ， 那 么 你 可 以 运行 alembic upgrade head 命令 
来 应 用 这 个 迁移 。 

















13.4 生成 SQL 


有 时 ， 你 会 希望 使 用 SQL 更 改 生 产 数据 库 的 模式 ，Alembic 对 此 提供 了 支持 。 这 在 变更 
管理 控制 更 为 严格 的 环境 中 很 常见 ， 对 于 那些 拥有 大 规模 分 布 式 环境 并 且 需 要 运行 许多 不 
同 数据 库 服 务 器 的 环境 来 说 也 是 如 此 。 这 个 过 程 和 我 们 在 第 12 章 做 的 “online”Alembic 
升级 是 一 样 的。 我 们 可 以 指定 SQL 的 起 始 版 本 和 结束 版 本 。 如 果 你 不 提供 初始 迁移 ， 
Alembic 将 创建 用 于 从 空 数据 库 升 级 的 SQL 脚本 。 示 例 13-4 演示 了 如 何 为 我 们 重 命名 的 
迁移 生成 SQL。 
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示例 13-4 生成 重 命名 迁移 SQL 


# alembic upgrade 34044511331:2e6a6cc63e9 --sql O9 

INFO [alembic.runtime.migration] Context impl SQLiteImpl. 

INFO [alembic.runtime.migration] Generating static SQL 

INFO [alembic.runtime.migration] Will assume non-transactional DDL. 

INFO [alembic.runtime.migration] Running upgrade 34044511331 -» 2e6a6cc63e9, 
Renaming cookies to new cookies 

-- Running upgrade 34044511331 -» 2e6a6cc63e9 





ALTER TABLE cookies RENAME TO new cookies; 


UPDATE alembic version SET version num-z'2e6a6cc63e9' 
WHERE alembic version.version num - '34044511331'; 


© A 34044511331 升级 到 2e6a6cc63e9, 





示例 13-4 的 输出 显示 了 重 命名 cookies 表 所 需 的 两 条 SQL 语句 ， 并 将 Alembic 迁移 级 别 
更 新 到 修订 ID 2e6a6cc63e9 指定 的 新 级 别 。 可 以 把 标准 输出 重 定向 到 我 们 选择 的 文件 ， 以 
便 将 其 写 入 文件 ， 如 下 所 示 : 





# alembic upgrade 34044511331:2e6a6cc63e9 --sql > migration.sql 

INFO [alembic.runtime.migration] Context impl SQLiteImpl. 

INFO [alembic.runtime.migration] Generating static SQL 

INFO [alembic.runtime.migration] Will assume non-transactional DDL. 

INFO [alembic.runtime.migration] Running upgrade 34044511331 -» 2e6a6cc63e9, 
Renaming cookies to new cookies 


命令 运行 完毕 后 ， 可 以 使 用 cat migration.sql 命令 查看 SQL 语句 ， 如 下 所 示 : 


# cat migration.sql 
-- Running upgrade 34044511331 -> 2e6a6cc63e9 


ALTER TABLE cookies RENAME TO new cookies; 
UPDATE alembic version SET version num-z'2e6a6cc63e9' 
WHERE alembic version.version num - '34044511331'; 


准备 好 SQL 语 名 之后， 就 可 以 使 用 数据 库 服务 器 中 的 工具 来 运行 它们 了 。 


如 果 你 在 一 个 数据 库 后 端 (比如 SQLite) 上 开发 ， 在 另 一 个 数据 库 (比如 
PostgreSQL) 上 部 署 ， 那 么 一 定 要 修改 sqlalchemy.url 配置 (我 们 曾 在 第 
11 章 中 配置 过 ) ， 将 其 更 改 为 PostgreSQL 数据 库 的 连接 字符 串 。 如 果 不 这 样 
做 ， 那 你 得 到 的 SQL 很 可 能 不 适合 你 的 生产 数据 库 。 为 了 避免 出 现 这 样 的 
问题 ， 我 总 是 在 实际 生产 中 使 用 的 数据 库 上 进行 开发 。 


























本 章 我 们 讲解 了 Alembic 的 基础 知识 ， 学 习 了 如 何 查 看 当前 迁移 级 别 、 迁 移 降 级 和 创建 
SQL 脚本 (这 些 脚本 可 以 直接 应 用 在 生产 数据 库 上 ， 而 无 须 使 用 Alembic) 。 如 果 想 了 解 更 
多 有 关 Alembic 的 内 容 ， 比 如 如 何 处 理 代码 分 支 ， 可 以 查看 Alembic 文档 。 





下 一 章 会 进一步 介绍 SQLAlchemy 的 用 法 ， 包 括 如 何在 Flask Web 框架 中 使 用 它 。 





E 
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第 14 章 


SQLAIchemy 的 高 级 应 用 





前 面 章节 详细 讲解 了 SQLAlchemy 的 方方面面 。 与 前 面 不 同 ， 本 章 不 会 讲 得 那么 细 ， 你 可 
以 把 本 章 内 容 看 作对 一 些 有 用 工具 的 快速 讲解 。 每 一 节 的 末尾 都 会 提供 一 些 参考 信息 ， 如 
果 你 感 兴趣 ， 可 以 从 中 学 到 更 多 相关 知识 。 请 注意 ， 各 节 内 容 并 不 是 完整 的 教程 ， 而 是 关 
于 如 何 完 成 特定 任务 的 简短 指南 。 本 章 第 一 部 分 主要 介绍 SQLAlchemy 的 一 些 高 级 用 法 ， 
第 二 部 分 介绍 SQLAlchemy 如 何 与 Flask 等 Web 框架 结合 使 用 ， 最 后 一 部 分 介绍 一 些 可 以 
与 SQLAlchemy 一 起 使 用 的 库 。 


14.1 混合 属性 

混合 属性 在 作为 类 方法 访问 时 表现 出 一 种 行为 ， 而 通过 实例 访问 时 又 表现 出 另 一 种 行为 。 
我 们 也 可 以 这 样 想 ， 当 混合 属性 用 在 SQLAlchemy 语句 中 时 会 生成 有 效 的 SQL， 而 通过 实 
例 访问 时 会 直接 对 实例 执行 Python 代码 。 要 理解 这 一 点 ， 我 发 现 最 好 的 方法 是 看 代码 。 下 
面 使 用 Cookie 类 对 此 进行 说 明 ， 如 示例 14-1 所 示 。 


























示例 14-1 Cookie 用 户 数据 模型 
from datetime import datetime 
from sqlalchemy import Column, Integer, Numeric, String, create engine 
from sqlalchemy.ext.declarative import declarative base 
from sqlalchemy.ext.hybrid import hybrid property, hybrid method 
from sqlalchemy.orm import sessionmaker 


engine - create engine('sqlite:///:memory:') 


Base - declarative base() 
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class Cookie(Base): 


. tablename | = 'cookies' 


cookie id = Column(Integer, primary key-True) 
cookie name - Column(String(50), index-True) 
cookie recipe url = Column(String(255)) 
cookie sku = Column(String(55)) 

quantity - Column(Integer()) 

unit cost - Column(Numeric(12, 2)) 


Ghybrid property © 
def inventory value(self): 
return self.unit cost * self.quantity 


@hybrid_method @ 
def bake_more(self, min_quantity): 
return self.quantity < min_quantity 


def _ repr (self): 
return "Cookie(cookie_name='{self.cookie_name}', " V 
"cookie recipe url-'([self.cookie recipe url]', " \ 
"cookie sku-'[self.cookie skuj', " X 
"quantity={self.quantity}, " V 
"unit cost-(self.unit cost]))".format(self-self) 


Base.metadata.create all(engine) 
Session = sessionmaker(bind-engine) 


o 创建 一 个 混合 属性 。 
@ 创建 一 个 混合 方法 ， 因 为 我 们 需要 一 个 额外 的 输入 来 做 比较 。 


在 示例 1 














4-1 中 ，inventory_value 是 一 个 混合 属性 ， 用 来 计算 Cookie 数据 类 的 两 个 属性 的 








乘积 ， 而 bake more 是 一 个 混合 方法 ， 它 需要 一 个 额外 的 输入 来 确定 我 们 是 否 应 该 烤 更 多 


cookie, 


(这 样 有 可 能 返回 false 吗 ? 总 是 有 地 方 来 存放 更 多 cookie! ) 数据 类 定义 好 之 后 ， 








就 可 以 天 








F 始 了 解 “ 混 合 ”的 真正 含义 了 。 让 我 们 看 看 在 查询 中 使 用 时 inventory value 是 








如 何 工 作 的 〈 见 示例 14-2)。 


示例 14-2 ”混合 属性 : 类 


print(Cookie.inventory value < 10.00) 





示例 14-2 的 输出 结果 如 下 : 


cookies.unit cost * cookies.quantity < :param 1 


























从 示例 14-2 的 输出 中 可 以 看 到 ， 混 合 属 性 被 扩展 为 一 个 有 效 的 SQL 子 句 。 这 意味 着 我 们 
可 以 对 这 些 属性 进行 算 选 、 排 序 、 分 组 ， 以 及 应 用 数据 库 国 数 。 下 面 再 打印 bake more 混 
合 方法 看 看 : 
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print(Cookie.bake more(12)) 
输出 结果 如 下 : 


cookies.quantity < :quantity 1 


同样 ， 它 使 用 混合 方法 中 的 Python 代码 中 构建 了 一 个 有 效 的 SQL 子 句 。 为 了 了 解 将 其 作 
为 实例 方法 访问 时 会 发 生 什 么 ， 我 们 需要 向 数据 库 添加 一 些 数 据 ， 如 示例 14-3 所 示 。 


示例 14-3 ”向 数据 库 添 加 一 些 记录 
session = Session() 
cc cookie = Cookie(cookie name-'chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe.html', 
cookie skuz'CC0O1', 
quantity-12, 
unit cost-0.50) 
dcc = Cookie(cookie name-'dark chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe dark.html', 
cookie skuz'CC02', 
quantity-1, 
unit cost-0.75) 
mol = Cookie(cookie name-'molasses', 
cookie recipe url-'http://some.aweso.me/cookie/recipe molasses.html', 
cookie sku-'MOLO01', 
quantity-1, 
unit cost-0.80) 
session.add(cc cookie) 
session.add(dcc) 
session.add(mol) 
session.flush() 








添加 了 这 些 数据 之 后 ， 我 们 就 可 以 看 看 通过 实例 使 用 混合 属性 和 混合 方法 时 会 发 生 什么 。 
我 们 可 以 访问 dec 实例 的 inventory value 属性 ， 如 下 所 示 : 








dcc.inventory value 
0.75 


可 以 看 到 ， 通 过 实例 使 用 inventory value 时 ， 它 会 执行 该 属性 内 部 的 Python 代码 。 这 正 
是 混合 属性 或 混合 方法 的 魔力 所 在 。 还 可 以 通过 实例 调用 bake more 混合 方法 ， 如 下 所 示 : 





dcc.bake more(12) 
True 





如 你 所 料 ， 当 通过 实例 调用 bake more 混合 方法 时 ， 它 会 执行 自身 的 Python 代码 。 到 这 
里 ， 我 们 已 经 了 解 了 混合 属性 和 混合 方法 的 工作 原理 ， 接 下 来 学 习 一 下 如 何在 查询 中 使 用 
它们 。 首 先 使 用 inventory value 属性 ， 如 示例 14-4 所 示 。 
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示例 14-4 在 查询 中 使 用 混合 属性 


from sqlalchemy import desc 


for cookie in session.query(Cookie).order by(desc(Cookie.inventory value)): 
print('{:>20} - (:.2fj'.format(cookie.cookie name, cookie.inventory value)) 





运行 示例 14-4， 会 得 到 如 下 结果 : 


chocolate chip - 6.00 
molasses - 0.80 
dark chocolate chip - 0.75 


从 运行 结果 可 以 看 出 ， 混 合 属 性 的 行为 和 ORM 的 类 属性 是 一 样 的 。 在 示例 14-5 H, RiT 
将 使 用 bake more 方法 来 确定 需要 烤 哪 种 cookie, 


示例 14-5 ”在 查询 中 使 用 混合 方法 
for cookie in session.query(Cookie).filter(Cookie.bake more(12)): 
print('{:>20} - (j'.format(cookie.cookie name, cookie.quantity)) 














运行 示例 14-5， 会 得 到 如 下 结果 : 


dark chocolate chip - 1 
molasses - 1 


这 和 我 们 希望 的 一 样 。 虽 然 这 些 行 为 来 自 于 我 们 的 代码 ， 但 是 混合 属性 可 以 做 更 多 事情 。 
你 可 以 阅读 SQLAlchemy 文档 中 有 关 混 合 属性 的 部 分 ， 学 习 更 多 相关 内 容 。 


14.2 ”关联 代理 


关联 代理 是 一 个 跨 关系 的 指针 ， 它 指向 某 个 特定 属性 。 通 过 关联 代理 ， 我 们 可 以 轻松 地 跨 
关系 访问 某 个 属性 。 例 如 ， 当 我 们 想 要 一 份 制作 cookie 所 需 的 原料 名 称 列表 时 ， 关 联 代理 
就 能 派 上 用 场 。 下 面 来 看 看 它 是 如 何 处 理 一 段 典 型 的 关系 的 。cookie 和 原料 之 间 是 多 对 多 
的 关系 。 示 例 14-6 创建 了 数据 模型 及 其 关系 。 
































示例 14-6 ”创建 模型 和 关系 


from datetime import datetime 

from sqlalchemy import (Column, Integer, Numeric, String, Table, 
ForeignKey, create engine) 

from sqlalchemy.orm import relationship 

from sqlalchemy.ext.declarative import declarative base 

from sqlalchemy.orm import sessionmaker 


engine = create engine('sqlite:///:memory:') 


Base - declarative base() 
Session = sessionmaker(bind-engine) 





cookieingredients table = Table('cookieingredients', Base.metadata, @ 
Column('cookie id', Integer, ForeignKey("cookies.cookie id"), 
primary key-True), 
Column('ingredient id', Integer, ForeignKey("ingredients.ingredient id"), 
primary key-True) 


class Ingredient(Base): 
__tablename__ = 'ingredients' 


ingredient_id = Column(Integer, primary_key=True) 
name = Column(String(255), index=True) 


def repr (self): 
return "Ingredient(name='{self.name}')".format(self=self) 


class Cookie(Base): 
__tablename__ = 'cookies' 


cookie_id = Column(Integer, primary_key=True) 
cookie_name = Column(String(50), index=True) 
cookie_recipe_url = Column(String(255)) 
cookie_sku = Column(String(55)) 

quantity = Column(Integer()) 

unit_cost = Column(Numeric(12, 2)) 


ingredients = relationship( "Ingredient", 
secondary=cookieingredients_table) @ 


def repr (self): 

return "Cookie(cookie_name='{self.cookie_name}', " \ 
"cookie recipe url-'([self.cookie recipe url]', " V 
"cookie sku-'[self.cookie skuj', " \ 
"quantity={self.quantity}, " V 
"unit cost-(self.unit cost))".format(self-self) 


Base.metadata.create all(engine) 


0 为 多 对 多 关系 创建 cookteingredients XE, 
O 通过 cookieingredients 表 创 建 与 原料 的 关系 。 


由 于 这 是 一 个 多 对 多 的 关系 ， 所 以 需要 创建 一 个 表 来 映射 多 个 关系 。 为 此 ， 我 们 创建 了 
cookieingredients_table。 接 下 来 需要 添加 一 种 cookie 和 一 些 原料 ， 如 下 所 示 : 


session = Session() 
cc cookie = Cookie(cookie_name='chocolate chip', © 
cookie recipe url-'http://some.aweso.me/cookie/recipe.html', 
cookie skuz'CC0O1', 
quantity-12, 
unit cost-0.50) 
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flour = Ingredient(name-'Flour') @ 

sugar - Ingredient(name-'Sugar') 

egg = Ingredient(name-'Egg') 

cc = Ingredient(name='Chocolate Chips') 

cc cookie.ingredients.extend([flour, sugar, egg, cc]) O 
session.add(cc cookie) 

session.flush() 


@ 创建 cookie。 

e 创建 原料 。 

© 添加 原料 至 cc_cookie.ingredients, 

为 了 把 原料 添加 到 cookie， 我 们 必须 创建 原料 ,然后 把 它们 添加 到 cc cookie 的 


ingredients 属性 。 现 在 ， 如 果 想 列 出 所 有 原料 的 名 称 (这 是 我 们 最 初 的 目标 )， 必 须 遍 历 
所 有 原料 并 获得 name 属性 。 可 以 使 用 如 下 代码 来 实现 这 个 目标 : 








[ingredient.name for ingredient in cc cookie.ingredients] 


返回 结果 如 下 : 





['Flour', 'Sugar', 'Egg', 'Chocolate Chips'] 


如 果 只 想 从 原料 获取 name 属性 ， 这 么 做 可 能 会 很 麻烦 。 使 用 传统 关系 还 需要 我 们 手动 创建 
每 种 原料 ， 并 将 其 添加 到 cookie 中 。 如 果 需 要 确定 某 种 原料 是 否 已 经 存在 ， 就 需要 做 更 多 
工作 。 这 种 情况 下 ， 就 要 用 到 关联 代理 了 ， 它 可 以 大 大 简化 这 种 用 法 。 














可 以 使 用 关联 代理 来 访问 属性 和 创建 原料 。 要 创建 关联 代理 ， 需 要 做 如 下 三 件 事 。 


。 导入 关联 代理 。 
。 向 目标 对 象 添 加 init 方法 ,方便 使 用 所 需 值 新 建 实例 。 
。 创建 关联 代理 ， 它 针对 的 是 你 想 代 理 的 表 名 和 列 名 。 


我 们 会 启动 一 个 新 的 Python shell， 并 再 次 创建 我 们 的 类 。 不 过 ， 这 一 次 我 们 要 添加 一 个 关 
联 代理 ， 以 便 更 容易 地 访问 原料 名 称 ， 如 示例 14-7 所 示 。 























示例 14-7 创建 关联 代理 
from sqlalchemy import create engine 
from sqlalchemy.orm import sessionmaker 


engine = create engine('sqlite:///:memory:') 
Session = sessionmaker(bind-engine) 
from datetime import datetime 


from sqlalchemy import Column, Integer, Numeric, String, Table, ForeignKey 
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from sqlalchemy.orm import relationship 
from sqlalchemy.ext.declarative import declarative base 
from sqlalchemy.ext.associationproxy import association proxy © 


Base - declarative base() 


cookieingredients table - Table('cookieingredients', Base.metadata, 
Column('cookie id', Integer, ForeignKey("cookies.cookie id"), 
primary key-True), 
Column('ingredient id', Integer, ForeignKey("ingredients.ingredient id"), 
primary key-True) 


class Ingredient(Base): 
__tablename__ = 'ingredients' 
ingredient_id = Column(Integer, primary_key=True) 
name = Column(String(255), index=True) 


def init (self, name): @ 
self.name = name 


def repr (self): 
return "Ingredient(name='{self.name}')".format(self=self) 


class Cookie(Base): 
__tablename__ = 'cookies' 


cookie_id = Column(Integer, primary_key=True) 
cookie_name = Column(String(50), index=True) 
cookie recipe url = Column(String(255)) 
cookie sku = Column(String(55)) 

quantity = Column(Integer()) 

unit_cost = Column(Numeric(12, 2)) 


ingredients = relationship("Ingredient", 
secondary=cookieingredients_table) 


ingredient_names = association_proxy('ingredients', 'name') © 


def repr (self): 
return "Cookie(cookie_name='{self.cookie_name}', " \ 
"cookie recipe url-'([self.cookie recipe url]', " \ 
"cookie sku-'[self.cookie skuj', " \ 
"quantity={self.quantity}, " V 
"unit cost-(self.unit cost])".format(self-self) 


Base.metadata.create all(engine) 
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0 导入 关联 代理 。 
@ 定义 _init 方法 ， 它 只 需要 一 个 名 称 。 
© 创建 到 原料 name 属性 的 关联 代理 ， 并 使 用 ingredient_names 引用 它 。 

















TT 








上 面 三 件 事 做 完 之 后 ， 就 可 以 像 前 面 那样 使 用 我 们 的 类 了 : 























session = Session() 
cc cookie = Cookie(cookie_name='chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe.html', 
cookie sku-'CC01', 
quantity-12, 
unit cost-0.50) 
dcc = Cookie(cookie_name='dark chocolate chip', 
cookie recipe url-'http://some.aweso.me/cookie/recipe dark.html', 
cookie sku-'CC02', 
quantity-1, 
unit cost-0.75) 
flour = Ingredient(name-'Flour') 
sugar = Ingredient(name-'Sugar') 
egg - Ingredient(name-'Egg') 
cc = Ingredient(name='Chocolate Chips') 
cc_cookie.ingredients.extend([flour, sugar, egg, cc]) 
session.add(cc_cookie) 
session.add(dcc) 
session.flush() 





这 里 ， 关 系 仍然 像 我 们 预想 的 那样 正常 工作 。 不 过 ， 为 了 获得 原料 名 称 ， 可 以 使 用 关联 代 
里 来 避 开 之 前 用 过 的 列表 推导 式 。 下 面 是 使 用 ingrendient_names 的 例子 。 














Nd 











cc cookie.ingredient names 

















得 到 的 结果 如 下 : 


['Flour', 'Sugar', 'Egg', 'Chocolate Chips'] 





这 比 遍历 所 有 原料 来 创建 原料 名 列表 要 容易 得 多 。 这 里 ， 我 们 忘 了 添加 一 种 关键 原料 一 一 
油 。 可 以 使 用 关联 代理 来 添加 这 种 新 原料 ， 如 下 所 示 : 





cc cookie.ingredient names.append('Oil') 
session.flush() 


当 我 们 这 样 做 的 时 候 ， 关 联 代理 会 使 用 Ingredient. init ”方法 自动 为 我 们 创建 一 种 新 
原料 。 但 需要 注意 的 是 ， 如 果 我 们 已 经 有 了 一 种 名 为 Oil 的 原料 ， 关 联 代理 还 是 会 为 我 们 
创建 它 。 这 可 能 会 导致 出 现 重复 的 记录 ， 或 者 在 添加 违反 约束 条 件 时 产生 异常 。 

为 了 解决 这 个 问题 ， 可 以 在 使 用 关联 代理 之 前 先 查 询 一 下 现 有 原料 。 示 例 14-8 演示 了 具体 
做 法 。 
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示例 14-8 ”过 滤 原 料 
dcc ingredient list = ['Flour', 'Sugar', 'Egg', 'Dark Chocolate Chips', 
'oil'] © 
existing_ingredients = session.query(Ingredient).filter( 
Ingredient.name.in (dcc ingredient list)).all() O 
missing - set(dcc ingredient list) - set([x.name for x in 
existing ingredients]) © 





@ 为 我 们 的 dark chocolate chip cookie 定义 原料 列表 。 
e 碍 询 数据 库 中 已 经 存在 的 原料 。 
e 通过 两 个 原料 集合 的 差 集 找 到 缺失 的 原料 。 











找到 已 经 有 的 原料 之 后 ， 将 其 与 所 需 原 料 列 表 进 行 比较 ， 判 断 少 了 什么 ， 这 里 是 “Dark 
Chocolate Chips”。 接 下 来 就 可 以 通过 关系 添加 所 有 现 有 原料 ， 而 后 通过 关联 代理 添加 新 原 
料 ， 如 示例 14-9 所 示 。 








示例 14-9 向 dark chocolate chip cookie 添加 原料 


dcc.ingredients.extend(existing ingredients) @ 
dcc.ingredient names.extend(missing) O 


@ 通过 关系 添加 现 有 原料 。 
@ 通过 关联 代理 添加 新 原料 。 








到 这 里 ， 我 们 就 可 以 使 用 如 下 代码 把 原料 名 打印 出 来 了 : 


dcc.ingredient names 

















这 会 得 到 如 下 结果 : 


['Egg', 'Flour', 'Oil', 'Sugar', 'Dark Chocolate Chips'] 





























当 我 们 把 新 旧 原 料 添加 到 cookie 时 ， 这 使 得 我 们 能 够 快速 处 理 它们 ， 并 且 所 得 到 的 输出 正 
是 我 们 想 要 的 。 关 联 代理 还 有 许多 其 他 用 途 ， 你 可 以 在 关联 代理 文档 中 了 解 更 多 信息 。 



































14.3 集成 SQLAIchemy 和 Flask 


我 们 经 常 看 到 SQLAlchemy 与 Flask Web 应 用 程序 一 起 使 用 。Flask 的 创建 者 创建 了 一 
个 Flask-SQLalchemy 包 来 简化 集成 过 程 。 使 用 Flask-SQLalchemy 会 得 到 预 配置 作用 域 
会 话 ， 它 们 与 Flask 应 用 程序 的 页 面 生 命 周期 绑 定 在 一 起 。 可 以 使 用 pip 来 安装 Flask- 
SQLalchemy, ZU Pr: 

















# pip install flask-sqlalchemy 


在 使 用 Flask-SQLalchemy 时 ， 强 烈 建议 你 使 用 app 工厂 模式 ， 这 不 是 Flask-SQLalchemy 
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文档 快速 上 手 部 分 使 用 的 模式 。app 工厂 模式 会 使 用 一 个 函数 把 所 有 合适 的 附加 组 伯 








F 和 配 


置 组 装 成 一 个 应 用 程序 。 这 通常 放 在 应 用 程序 的 app/ init .py 文件 中 。 示 例 14-10 演示 
了 如 何 构 造 create_app 方法 。 





示例 14-10 app 工厂 函数 


from flask import Flask 
from flask.ext.sqlalchemy import SQLAlchemy 


from config import config 

db = SQLAlchemy() @ 

def create app(config name):@ 
app = Flask( name ) 


app.config.from object(config[config name]) 


db.init app(app) © 
return app 


@ 创建 一 个 未 配置 的 Flask-SQLAlchemy 实例 。 
@ 定义 create_app 工厂 。 
© 使 用 app 上 下 文 初始 化 实例 。 


app 工厂 需要 一 个 配置 文件 来 定义 Flask 设置 和 SQLAlchemy 连接 字符 串 。 在 示例 14-11 
中 ， 我 们 在 应 用 程序 根 目 录 下 定义 了 一 个 配置 文件 config.py。 





示例 14-11  Flask app 配置 


import os 


basedir = os.path.abspath(os.path.dirname( file )) 


class Config: © 
SECRET KEY - 'development key' 
ADMINS = frozenset(['jason@jasonamyers.com', ]) 


class DevelopmentConfig(Config): @ 
DEBUG = True 
SQLALCHEMY_DATABASE_URI = "sqlite:////tmp/dev.db" 


class ProductionConfig(Config): © 
SECRET KEY - 'Prod key' 
SQLALCHEMY. DATABASE URI = "sqlite:////tmp/prod.db" 





config - ( O 
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'development': DevelopmentConfig, 
'production': ProductionConfig, 
'default': DevelopmentConfig 





义 基 本 Falsk 配置 。 
义 开 发 时 使 用 的 配置 。 


o 
e 
e 定义 实际 生产 环境 中 使 用 的 配置 。 





@ 定义 一 个 字典 ， 用 来 完成 从 简单 名 称 到 配置 类 的 映射 。 


准备 好 app 工厂 和 配置 之 后 ， 我 们 就 有 了 一 个 功能 正常 的 Flask 应 用 程序 。 接 下 来 ， 可 以 
定义 数据 类 了 。 在 apps/models.py 中 ， 定 义 Cookie 模型 ， 如 示例 14-12 所 示 。 





示例 14-12 X Cookie 模型 
from app import db 


class Cookie(db.Model): 
. tablename  - 'cookies' 








cookie id - db.Column(db.Integer(), primary key-True) 
cookie name - db.Column(db.String(50), index-True) 
cookie recipe url = db.Column(db.String(255)) 


quantity - db.Column(db.Integer()) 








ADC Be, SLER AIA SER EE db. session 对 象 中 


在 示例 14-12 中 ， 我 们 使 用 了 在 app/_init_.py 中 创建 的 db 实例 来 访问 SQLAlchemy PERS 
大 部 分 。 现 在 ， 可 以 在 查询 中 使 用 Cookie 模型 了 ， 就 像 我 们 讲 ORM 时 所 做 的 那样 。 唯 

















o 


此 外 ，Flask-SQLAlchemy 在 每 个 ORM 数据 类 中 添加 了 query 方法 ， 这 在 普通 SQLAIchemy 








代码 中 是 看 不 到 的 。 强 烈 建议 你 不 要 使 用 这 种 语法 ， 


合 配 用 时 可 能 会 引起 混乱 。 这 种 查询 风格 看 起 来 像 下 面 这 样 : 


Cookie.query.all() 











因为 这 在 与 其 他 SOLAlchemy 查询 混 











学 完 上 面 这 些 内 容 ， 你 应 该 了 解 了 如 何 将 SQLAIchemy 与 Flask 集成 在 一 起 。 你 可 以 阅读 
Flask-SQLalchemy 文档 了 解 更 多 内 容 。Miguel Grinberg 写 了 一 本 很 棒 的 书 一 一 《Flask Web 


开发 》'， 其 中 介绍 了 如 何 构 建 一 个 完整 的 应 用 程序 。 


14.4 SQLAcodegen 


我 们 在 第 5 章 学 习 了 SQLAlchemy Core 的 反射 ， 并 在 第 10 章 学 习 了 与 ORM 结合 使 用 的 








自动 映射 (automap)。 虽 然 这 两 种 解决 方案 都 很 棒 ， 





















































iE: 此 书 已 由 人 民 邮 电 出 版 社 出 版 ， 详 情 请 见 http:/www.ituring.com.cn/book/2463。 一 一 编者 注 








但 是 它们 要 求 每 次 重启 应 用 程序 时 
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都 执行 反射 ， 或 者 在 动态 模块 的 情况 下 ， 每 次 重新 加 载 模块 时 都 执行 反射 。SQLAcodegen 
使 用 反射 构建 一 系列 ORM 数据 类 ， 你 可 以 在 应 用 程序 代码 库 中 使 用 它们 来 避免 多 次 反射 
数据 库 。SQLAcodegen 能 够 检测 出 多 对 一 、 一 对 一 和 多 对 多 的 关系 。 可 以 通过 pip 安装 
SQLAcodegen， 如 下 所 示 : 





pip install sqlacodegen 








要 运行 SQLAcodegen， 需 要 为 它 指定 一 个 数据 库 连 接 字符 串 来 进行 连接 。 我 们 使 用 前 面 
用 过 的 Chinook 数据 库 的 副本 〈 你 可 以 在 本 书 示例 代码 的 CH14/ 文 件 夹 中 找到 它 )。 在 
CH14/ 文件 夹 中 ， 使 用 合适 的 连接 字符 串 运 行 SQLAcodegen 命令 ， 如 示例 14-13 所 示 。 














示例 14-13 ”针对 Chinook 数据 库 运行 SQLAcodegen 
# sqlacodegen sqlite:///Chinook_Sqlite.sqlite © 


# coding: utf-8 

from sqlalchemy import (Table, Column, Integer, Numeric, Unicode, DateTime, 
ForeignKey) 

from sqlalchemy.orm import relationship 

from sqlalchemy.ext.declarative import declarative base 


Base - declarative base() 
metadata - Base.metadata 


class Album(Base): 
. tablename | = 'Album' 


AlbumId = Column(Integer, primary key-True, unique-True) 
Title = Column(Unicode(160), nullable-False) 
ArtistId - Column(ForeignKey(u'Artist.ArtistId'), nullable-False, index-True) 


Artist - relationship(u'Artist') 


class Artist(Base): 
. tablename  - 'Artist' 


ArtistId - Column(Integer, primary key-True, unique-True) 
Name - Column(Unicode(120)) 


class Customer(Base): 
. tablename  - 'Customer' 


CustomerId - Column(Integer, primary key-True, unique-True) 
FirstName - Column(Unicode(40), nullable-False) 

LastName - Column(Unicode(20), nullable-False) 

Company = Column(Unicode(80)) 

Address - Column(Unicode(70)) 

City = Column(Unicode(40)) 

State = Column(Unicode(40)) 

Country = Column(Unicode(40) ) 





PostalCode = Column(Unicode(10)) 

Phone = Column(Unicode(24)) 

Fax = Column(Unicode(24)) 

Email = Column(Unicode(60), nullable-False) 

SupportRepId = Column(ForeignKey(u'Employee.EmployeeId'), index=True) 


Employee = relationship(u'Employee') 


class Employee(Base): 
__tablename__ = 'Employee' 


EmployeeId = Column(Integer, primary_key=True, unique=True) 
LastName = Column(Unicode(20), nullable=False) 

FirstName = Column(Unicode(20), nullable-False) 

Title = Column(Unicode(30)) 

ReportsTo = Column(ForeignKey(u'Employee.EmployeeId'), index=True) 
BirthDate = Column(DateTime) 

HireDate = Column(DateTime) 

Address = Column(Unicode(70) ) 

City = Column(Unicode(40) ) 

State = Column(Unicode(40) ) 

Country = Column(Unicode(40)) 

PostalCode = Column(Unicode(10)) 

Phone = Column(Unicode(24) ) 

Fax = Column(Unicode(24)) 

Email = Column(Unicode(60) ) 


parent = relationship(u'Employee', remote side-[EmployeeId]) 


class Genre(Base): 
__tablename__ = 'Genre' 


GenreId = Column(Integer, primary_key=True, unique-True) 
Name = Column(Unicode(120)) 


class Invoice(Base): 
__tablename__ = 'Invoice' 


InvoiceId = Column(Integer, primary_key=True, unique=True) 

CustomerId = Column(ForeignKey(u'Customer.CustomerId'), nullable-False, 
index=True) 

InvoiceDate = Column(DateTime, nullable-False) 

BillingAddress = Column(Unicode(70)) 

BillingCity = Column(Unicode(40)) 

BillingState = Column(Unicode(40)) 

BillingCountry = Column(Unicode(40) ) 

BillingPostalCode = Column(Unicode(10)) 

Total = Column(Numeric(10, 2), nullable=False) 


Customer = relationship(u'Customer') 


class InvoiceLine(Base): 
__tablename__ = 'InvoiceLine' 
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InvoiceLineId = Column(Integer, primary key-True, unique-True) 


InvoiceId - Column(ForeignKey(u'Invoice.InvoiceId'), nullable-False, index-True) 


TrackId = Column(ForeignKey(u'Track.TrackId'), nullable-False, index=True) 
UnitPrice = Column(Numeric(10, 2), nullable-False) 
Quantity = Column(Integer, nullable=False) 


Invoice = relationship(u'Invoice' ) 
Track = relationship(u'Track') 


class MediaType(Base): 
__tablename__ = 'MediaType' 


MediaTypeId = Column(Integer, primary_key=True, unique=True) 
Name = Column(Unicode(120)) 


class Playlist(Base): 
__tablename__ = 'Playlist' 


PlaylistId = Column(Integer, primary_key=True, unique=True) 
Name = Column(Unicode(120)) 


Track = relationship(u'Track', secondary='PlaylistTrack' ) 


t_PlaylistTrack = Table( 
'PlaylistTrack', metadata, 
Column('PlaylistId', ForeignKey(u'Playlist.PlaylistId'), primary key-True, 
nullable-False), 


Column('TrackId', ForeignKey(u'Track.TrackId'), primary key-True, nullable-False, 


index-True), 
Index('IPK PlaylistTrack', 'PlaylistId', 'TrackId', unique-True) 


class Track(Base): 
. tablename  - 'Track' 


TrackId = Column(Integer, primary key-True, unique-True) 

Name - Column(Unicode(200), nullable-False) 

AlbumId = Column(ForeignKey(u'Album.AlbumId'), index-True) 

MediaTypeId = Column(ForeignKey(u'MediaType.MediaTypeId'), nullable-False, 
index-True) 

GenreId = Column(ForeignKey(u'Genre.GenreId'), index-True) 

Composer - Column(Unicode(220)) 

Milliseconds = Column(Integer, nullable=False) 

Bytes = Column(Integer) 

UnitPrice = Column(Numeric(10, 2), nullable=False) 


Album = relationship(u'Album') 
Genre = relationship(u'Genre' ) 
MediaType = relationship(u'MediaType' ) 


O 对 本 地 的 Chinook SQLite 数据 库 运 行 SQLAcodegen, 





如 示例 14-13 所 示 ， 运 行 这 个 命令 时 ， 它 会 创建 一 个 完整 的 文件 ， 其 中 包含 数据 库 的 所 有 
ORM 数据 类 以 及 正确 的 导入 。 这 个 文件 可 以 在 我 们 的 应 用 程序 中 使 用 。 如 果 Base 对 象 是 

















在 其 他 地 方 创建 的 ， 你 可 能 需要 调整 它 的 设置 。 还 可 以 通过 使 用 --tables 参数 仅 为 几 个 表 





生成 代码 。 在 示例 14-14 中 ， 我 们 选择 对 Artist 和 Track 表 运 行 SQLAcodegen。 








示例 14-14 对 Artist 和 Track 表 运 行 SQLAcodegen 


# sqlacodegen sqlite:///Chinook_Sqlite.sqlite --tables Artist,Track © 


# coding: utf-8 

from sqlalchemy import Column, ForeignKey, Integer, Numeric, Unicode 
from sqlalchemy.orm import relationship 

from sqlalchemy.ext.declarative import declarative base 


Base - declarative base() 
metadata - Base.metadata 


class Album(Base): 
. tablename  - 'Album' 


AlbumId = Column(Integer, primary key-True, unique-True) 
Title = Column(Unicode(160), nullable-False) 
ArtistId = Column(ForeignKey(u'Artist.ArtistId'), nullable-False, index-True) 


Artist = relationship(u'Artist') 


class Artist(Base): 
__tablename__ = 'Artist' 


ArtistId = Column(Integer, primary_key=True, unique=True) 
Name = Column(Unicode(120) ) 


class Genre(Base): 
__tablename__ = 'Genre' 


GenreId = Column(Integer, primary key-True, unique-True) 
Name - Column(Unicode(120)) 


class MediaType(Base): 
__tablename__ = 'MediaType' 


MediaTypeId = Column(Integer, primary_key=True, unique=True) 
Name = Column(Unicode(120) ) 


class Track(Base): 
__tablename__ = 'Track' 
TrackId = Column(Integer, primary_key=True, unique=True) 
Name = Column(Unicode(200), nullable=False) 
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AlbumId = Column(ForeignKey(u'Album.AlbumId'), index-True) 

MediaTypeId = Column(ForeignKey(u'MediaType.MediaTypeId'), nullable-False, 
index-True) 

GenreId = Column(ForeignKey(u'Genre.GenreId'), index=True) 

Composer - Column(Unicode(220)) 

Milliseconds = Column(Integer, nullable-False) 

Bytes = Column(Integer) 

UnitPrice = Column(Numeric(10, 2), nullable-False) 


Album = relationship(u'Album') 
Genre = relationship(u'Genre') 
MediaType = relationship(u'MediaType') 


@ 对 本 地 Chinook SQLite 数据 库 运 行 SQLAcodegen， 但 只 针对 Artist 和 Track 两 个 表 。 


当 我 们 在 示例 14-14 中 指定 Artist 和 Track 两 个 表 时 ，SQLAcodegen 会 为 这 两 个 表 以 及 所 
有 与 它们 有 关系 的 表 创建 类 。SQLAcodegen 这 样 做 是 为 了 确保 其 构建 的 代码 可 以 使 用 。 如 
果 想 把 生成 的 类 直接 保存 到 文件 中 ， 可 以 使 用 标准 重 定向 ， 如 下 所 示 : 








# sqlacodegen sqlite:///Chinook_Sqlite.sqlite --tables Artist,Track > db.py 


如 果 想 了 解 SQLAcodegen 的 更 多 功能 ， 可 以 使 用 SQLAcodegen -help 命令 查看 更 多 选项 。 


撰写 本 








到 这 里 ， 


区 时 ， 尚 不 存在 任何 有 关 SQLAcodegen 的 官方 文档 。 
本 章 内 容 就 全 部 讲 完了 。 和 希望 你 喜欢 这 几 个 关于 SQLAIchemy 高 级 用 法 的 例子 。 





第 15 章 





接 下 来 做 什么 





BUTE 











i 我 们 学 习 了 如 何 使 用 SOLAlchemy Core 和 SQLAlchemy ORM 以 及 Alembic 数据 库 迁 





移 工具 ， 和 希望 你 在 这 个 过 程 中 学 得 开心 。 请 记 住 ，SQLAlchemy 网 站 上 有 大 量 的 文档 以 及 
各 种 会 议 的 演示 文稿 ， 通 过 它们 ， 你 可 以 更 详细 地 了 解 特 定 主题 。PyVideo 网 站 上 也 有 一 
些 关 于 SQLAlchemy 的 演讲 视频 ， 其 中 有 几 个 还 是 我 制作 的 。 











下 一 步 怎 么 做 ， 主 要 取决 于 你 想 用 SQLAlchemy 做 什么 。 


如 果 你 想 了 解 关 于 Flask 和 SQLAlchemy 的 更 多 信息 ,请 阅读 Miguel Grinberg 写 的 《Flask 
Web 开发 》 一 书 。 

如 果 你 想 学 习 更 多 关于 测试 或 如 何 使 用 pytest 的 内 容 ，Alex Grönholm 写 了 几 篇 优秀 的 
关于 有 效 测 试 策略 的 博客 文章 : 第 一 部 分 (http://alextechrants.blogspot.fi/2013/08/unit- 
testing-sglalchemy-apps.html) 和 第 二 部 分 (http://alextechrants.blogspot.fi/2014/01/unit- 
testing-sglalchemy-apps-part-2.html) ， 很 值得 读 一 读 。 

如 果 你 想 了 解 更 多 有 关 SQLAlchemy 插件 和 扩展 的 内 容 ， 请 查看 Hong Minhee 的 
Awesome SQLAlchemy。 其 中 介绍 了 大 量 与 SQLAlchemy 相关 的 技术 。 

如 果 你 想 了 解 更 多 有 关 SQLAlchemy 内 部 原理 的 内 容 , 可 以 阅读 Mike Bayer 撰写 的 “The 
Architecture of Open Source Applications” 一 文 。 








希望 你 在 这 本 书 中 学 到 的 知识 能 够 帮 你 打下 坚实 的 基础 ， 助 你 进一步 提高 自己 的 技能 。 视 
愿 你 在 今后 的 工作 、 学 习 和 生活 中 一 切 顺利 ! 
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